This guide outlines the information and procedures necessary to import media assets and metadata into DF Studio using the Simple Storage Service (S3) provided by Amazon Web Services (AWS). This process consists of creating a storage location to house the files (known as an “S3 bucket”), generating access credentials, and granting access for DF Studio to ingest the files.
Create an S3 Bucket
An AWS account will be required. For more detailed information, please visit Amazon’s S3 Knowledge Base
After the AWS account is set up, log in to the console to open the Services menu and select S3 from the Storage category.
If no buckets exist, it will be necessary to create a new one.
Click the “Create Bucket” button to make a new bucket. Choose a name for the bucket.
Note that S3 bucket names are global and must be unique across the entire S3 platform.
Select the “US East (N. Virginia)” region and click the “Create” button. This will create a new S3 bucket under the Amazon S3 section.
Choosing a region other than the recommended option could increase migration time and costs. Please reach out to DF Studio Support with any questions.
Create an AWS Access Key ID and Secret Access Key
In order to access the bucket and upload content for migration, it will be necessary to generate a set of security credentials. These consist of an Access Key ID and a Secret Access Key.
On the top right side of the page, click to open the account menu, and select the option labeled My Security Credentials.
Open the Access keys section of the credentials page and click the “Create New Access Key” button.
Keys can be displayed on the screen, or downloaded in a Key File. Click the Show Access Key option to view the Access Key ID and Secret Access Key. These credentials will be required in order to connect to the S3 bucket.
It is very important to store a copy of these credentials securely during this step (never in plaintext), as these keys will not be able to be displayed again.
Upload Files to the S3 Bucket
Using any S3-compatible file transfer utility, gather all files intended for migration into DF Studio and transfer them into the S3 bucket. Example transfer utilities include:
- Cyberduck macOS & Windows
(How to connect to Amazon S3) - FileZilla Pro macOS & Windows
(Connect to Amazon S3 with FileZilla Pro) - Transmit macOS
(Amazon S3 in Transmit | IAM Roles for Amazon S3)
Grant DF Studio Access to the S3 Bucket
DF Studio’s system will need access to the S3 bucket in order to ingest files. This access can be granted by a Bucket Policy Access Control List (ACL), or by configuring user policies in IAM. Configure these settings by clicking the bucket name from the S3 Storage page, then clicking the Permissions tab.
Configure a Bucket Policy ACL
A bucket policy is a snippet of JSON-formatted text, provided by DF Studio, which will give the migration system access to the content staged in the S3 bucket for ingestion. Scroll to the Bucket policy section of the Permissions tab, then click the “Edit” button to modify.
A sample bucket policy looks like this:
{
"Id": "Policy1611785295336”,
"Version": "2015-10-21”,
"Statement": [
{
"Sid": "Stmt1611785290941”,
"Action": [
"s3:GetObject”,
"s3:ListBucket”
],
"Effect": "Allow”,
"Resource": "arn:aws:s3:::my-example-bucket”,
"Principal": {
"AWS": ["DFStudio”]
}
}
]
}
See Additional Bucket Policy Examples from the AWS knowledge base.
Configure a User Policy With the IAM Control Panel
If a custom bucket policy is preferred, or it is preferable to use the IAM panel to control DF Studio’s access to the S3 bucket, please reach out to DF Studio Support to coordinate IAM account details.
Access the AWS Policy Generator for further assistance.