Version: eXtendFiles 1.6.15 and
above
Audience: Administrator
Summary
This article guides you through the
process of setting up direct file uploads from
your browser to Amazon Web Services (AWS) S3
using eXtendFiles. By bypassing eXtendFiles
servers, you can significantly improve your
file upload speed using a direct connection to
Amazon S3. The configuration must be
carried out by a user with an Administrator
role in NetSuite and a user with Administrator
access to AWS.
Prerequisites
- eXtendFiles is configured and connected to
Amazon S3: Configure eXtendFiles
for Storage with Amazon S3.
Amazon Web Services Configuration
For the most up-to-date
instructions, follow Amazon's Configuring cross-origin
resource sharing
(CORS) documentation to configure
the Amazon S3 bucket to allow direct uploads
from your eXtendFiles subdomain. Additionally,
sample instructions (as of May 2024) are
below.
- Access your Amazon S3 account and open a bucket which is in use with eXtendFiles.Note: If you are using multiple buckets, this configuration will need to be done for each S3 bucket which is in use by eXtendFiles.
- Go to the "Permissions" tab.
- Edit the "Cross-origin resource sharing
(CORS)" configuration to add or update the
existing CORS configuration.
A sample CORS configuration is
demonstrated below. Replace YOUR_SUBDOMAIN with the subdomain listed on the eXtendFiles
Approval Setup screen at eXtendTech → eXtendFiles → eXtendFiles Approval
Setup. If you're using the same S3
bucket in multiple NetSuite environments, make
sure to list the subdomain used in each
environment in the "AllowedOrigins"
element.
[
{
"AllowedHeaders": ["*"],
"AllowedMethods": ["PUT"],
"AllowedOrigins": ["https://YOUR_SUBDOMAIN.cf.suitextend.net"],
"ExposeHeaders": ["ETag"]
}
]
NetSuite Configuration
Enable the direct upload option on the
eXtendFiles Setup screen.
- Go to eXtendTech → eXtendFiles → eXtendFiles
Setup.
- Select the "Amazon S3" sublist under
the Storage Information subtab.
- Enable the "Direct Uploads to S3" preference.
- Save the eXtendFiles Setup page.
Make sure to
complete the AWS configuration prior to
enabling this preference.
Frequently Asked Questions (FAQs)
Q: Why am I
receiving a "File upload failed due to
network or CORS error"?
A: This error occurs when "Direct Uploads to S3" is enabled in eXtendFiles, but the "Cross-origin resource sharing (CORS)" configuration for the bucket in S3 is not properly set up.
A: This error occurs when "Direct Uploads to S3" is enabled in eXtendFiles, but the "Cross-origin resource sharing (CORS)" configuration for the bucket in S3 is not properly set up.