Using S3 to Share Files with Traverse

Overview

Traverse will provide access to a shared S3 bucket in order to facilitate easy and secure transfer of files. Sending Traverse files via S3 requires 2 simple steps:

  1. Configure AWS access
  2. Push the file to S3

Configuring AWS Access

If your organization has an account with Amazon Web Services, IAM Roles are the best way for Traverse to provision your account with access to our shared bucket.

  1. Create or choose an IAM Role that you will use to push files
  2. Attach our bucket policy to the role
  3. Provide Traverse with the ARN of your role

If you do not have an account with AWS, Traverse will provision you with an access key and secret key that you may use to push files to S3.

Pushing Files to S3

Traverse will provide you with your own private directory within our shared bucket, named for your unique client ID.

Please upload files to the {YOUR-CLIENT-ID}/incoming directory and retrieve
files from the {YOUR-CLIENT-ID}/outgoing directory.

Our bucket name is traverse-partners

AWS CP Command

You will use the aws cp command to upload files, like so:

aws s3 cp {source file} {destination file} --acl bucket-owner-full-control

Full cp documentation may be found here.

Fixing object permissions

If a file was improperly uploaded, you may be asked to fix its permissions, like so:

aws s3api put-object-acl --bucket traverse-partners --key {the path to your file} --acl bucket-owner-full-control