TABLE OF CONTENTS


Use Case

MAC provides capabilities to upload assets from S3 folder. It is the most secure, scalable and high performing way to store files nowadays.

Upload from S3 folder is recommended for batch uploading in MAC. It supports uploading of product assets.



How to get data for connecting to S3 folder

Authorization is required to upload assets in MAC via S3 folder. So that, please request data for connection from MAC Support.  

A user should be provided with the following parameters:

AccessKeycountry-dependent value (will be provided by Support Team)
SecretKeycountry-dependent value (will be provided by Support Team)
Bucket Namecountry-dependent value (will be provided by Support Team)



Tools for uploading assets from S3 folder%3CmxGraphModel%3E%3Croot%3E%3CmxCell%20id%3D%220%22%2F%3E%3CmxCell%20id%3D%221%22%20parent%3D%220%22%2F%3E%3CmxCell%20id%3D%222%22%20value%3D%221%22%20style%3D%22ellipse%3BwhiteSpace%3Dwrap%3Bhtml%3D1%3Baspect%3Dfixed%3BfillColor%3D%2300EB00%3BstrokeColor%3D%2382b366%3BfontColor%3D%23FFFFFF%3BfontSize%3D16%3BfontStyle%3D1%22%20vertex%3D%221%22%20parent%3D%221%22%3E%3CmxGeometry%20x%3D%221865%22%20y%3D%221442.02392578125%22%20width%3D%2230%22%20height%3D%2230%22%20as%3D%22geometry%22%2F%3E%3C%2FmxCell%3E%3C%2Froot%3E%3C%2FmxGraphModel%3E 

For Windows we recommend using S3 Browser or Cyberduck. 

For macOS we recommend using Cyberduck. 

1. S3 Browser

Step 1: Create an account

For this step you need to specify:

  • Account Name - here you can type any free text
  • Account Type - please select 'Amazon S3 Storage'
  • Access Key ID - please enter the value provided by Support Team
  • Secret Access Key - please enter the value provided by Support Team
  • Use secure transfer (SSL/TLS) - please tick this checkbox to make your uploading secure

After data mentioned above is populated - please press 'Add new account'.

Please find below a couple screenshots related to this step.



Step 2: Add an External Bucket

System will ask you to add an External Bucket automatically. 

For this step you need to specify:

  • Bucket Name - please enter the value provided by Support Team.

Please find a couple of the screenshots below.




Step 3: Upload assets

Please press 'Upload', choose 'Upload File(s)' option and select assets for uploading.

Once you upload asset in S3 folder - you will see them in it for a moment. Product assets should have filenames that comply with MAC naming convention (see article Product Assets types and naming conventions) .

Once assets are processed and uploaded in MAC successfully - they will disappear from S3 folder.

Assets can be rejected for uploading in MAC due to some reasons. In this case they will disappear from S3 folder and will be moved to 'Not processed' or 'Duplicates not uploaded' folder that depends on the reason for rejection.



2. Cyberduck

Step 1: Create connection

Please click 'Open Connection'. To complete this action you need to specify:

  • type of connection - please select in a dropdown 'Amazon S3'
  • Access Key ID - enter the value provided by Support Team
  • Secret Access Key - enter the value provided by Support Team

In the bottom of the window press 'More options' and type in 'Path' bucket name - enter the value provided by Support Team.

Then click 'Connect' button.

Please find a couple of screenshots below about this step.





Step 2: Upload files

Please press 'Upload' and select assets.

Once you upload asset in S3 folder - you will see them in it for a moment. Product assets should have filenames that comply with MAC naming convention (see article Product Assets types and naming conventions) .

Once assets are processed and uploaded in MAC successfully - they will disappear from S3 folder.

Assets can be rejected for uploading in MAC due to some reasons. In this case they will disappear from S3 folder and will be moved to 'Not processed' or 'Duplicates not uploaded' folder that depends on the reason for rejection.


3. Native S3 functionality - fallback option

Please contact MAC Support to request data for connection with this approach.



If you have to approve the assets, please follow the instruction https://metroassetcenter.freshdesk.com/a/solutions/articles/15000028027


Original AWS documentation

Please find here a link to original AWS documentation: 

https://docs.aws.amazon.com/s3/index.html

https://docs.aws.amazon.com/AmazonS3/latest/API/Welcome.html