Setting up S3 Integration in 2018.1
Version: 2018.1 +
This document's purpose is to detail the system properties required for Amazon S3 integration.
- With MediaBeacon shut down, navigate to your mediabeacon.properties file and enter the properties below with appropriate values.
- On Windows Server 2012, this can be found in a place like the following: "C:\Users\Administrator\Appdata\local\MediaBeacon\mediabeacon.properties"
- If you have external systems (Research, Preview, Portal, etc) make sure to place the same system properties with the same values on those systems as well.
System Properties
aws.accessKeyId
- Use: the Amazon S3 access key used to access your bucket.
aws.secretKey
- Use: the Amazon S3 secret key used to access your bucket.
aws.defaultBucket
- Use: the default bucket you want to upload objects to.
- Values: string.
- Notes: there is no value set by default so you must set this on configuration.
aws.defaultRegion
- Use: the default region you want to use for S3 integration.
- Values: string.
- Notes: there is not a value set by default in MB, but it is recommended to use something like 'us-east-2' for your region if you're unsure of what to use as the default.
2. Enable your bucket with CORS by following the steps below:
- Navigate to your bucket in the S3 interface.
- Click on Permissions.
- Click on CORS Configuration.
- Enter your CORS configuration in the text area on the page.
- Click Save.
CORS Configuration
You must enable your bucket for CORS if necessary. The following is an example configuration that opens your bucket to be modified from any host.
<?xml version="1.0" encoding="UTF-8"?> <CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/"> <CORSRule> <AllowedOrigin>*</AllowedOrigin> <AllowedMethod>GET</AllowedMethod> <AllowedMethod>POST</AllowedMethod> <AllowedMethod>PUT</AllowedMethod> <AllowedMethod>DELETE</AllowedMethod> <AllowedHeader>*</AllowedHeader> </CORSRule> </CORSConfiguration>
For more information on CORS and S3 visit https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html.
[image: Se-integration]
3. Start MediaBeacon.