Setting Up Amazon S3
If you have not created an Amazon account, be sure to register for an account at Amazon S3. Once you have your account created, you will need to login to Amazon Console.
Obtaining Access Keys
You'll first need to generate your Access ID and Secret Key through the Amazon Console. Once logged in, hover over your name on the top-right corner and click on Security Credentials.
Then, click on the Create New Access Key button as shown in the screnshot below.
Upon creation, you'll need to click on Show Access Key as you'll need to copy both; Access Key ID and Secret Access Key to a safe location.
Important: Access Key ID and Secret Access Key need to be stored safely because it will later be used when configuring EasyDiscuss integration.
EasyDiscuss Amazon S3 Integration
Navigate to EasyDiscuss > Settings > Attachments > Storage. The default storage is Local. So, you'll need to select Amazon S3 from the dropdown.
Copy the Access Key ID and Secret Access Key that previously stored, into the remote storage settings as shown in the screenshot below.
Note: It is recommended to utilize cronjob for EasyDiscuss to upload the files over to Amazon S3 silently. Read more on Cronjobs Configuration.
Amazon S3 Known Issue
Rules for Bucket Naming
After you create an S3 bucket, you can't change the bucket name, so choose the name wisely.
Important: On March 1, 2018, Amazon S3 has updated their naming conventions for S3 buckets. Further reading can be read at Amazon S3 Bucket Guideline
Bucket names must be unique across all existing bucket names in Amazon S3.
- Bucket names must comply with DNS naming conventions.
- Bucket names must be at least 3 and no more than 63 characters long.
- Bucket names must not contain uppercase characters or underscores.
- Bucket names must start with a lowercase letter or number.
- Bucket names must be a series of one or more labels. Adjacent labels are separated by a single period (.). Bucket names can contain lowercase letters, numbers, and hyphens. Each label must start and end with a lowercase letter or a number.
- Bucket names must not be formatted as an IP address (for example, 192.168.5.4).
- When you use virtual hosted–style buckets with Secure Sockets Layer (SSL), the SSL wildcard certificate only matches buckets that don't contain periods. To work around this, use HTTP or write your own certificate verification logic. We recommend that you do not use periods (".") in bucket names when using virtual hosted–style buckets.
Could not upload avatars
EasyDiscuss tries to retrieve avatars from Amazon S3, however failed because of Amazon's library isn't downloading the avatars.
This issue is related to allow_url_fopen on PHP. You'll need to enable this in order to fetch images from Amazon S3. Please consult with your hosting provider for further information.