Save Files to Amazon S3 Cloud Storage

You can set up MASV to save files to Amazon S3 storage that you’re already using

You can set up MASV to save files to Amazon S3 storage that you’re already using:

• First, set up your S3 bucket in AWS. 
• Then, in the MASV Web App add a Cloud Integration and create a MASV Portal. 

A Cloud Integration specifies how to connect MASV to a third-party cloud service. A Portal is a simple and easy way for your clients and collaborators to send files to you, they don’t even need a MASV account. 

All Portals have the format

https://domain.portal.massive.app

where domain is unique for each Portal that you create. After you’re set up, you can start receiving files. Your collaborators can visit the Portal URL with their web browser or they can use the MASV Desktop app. To learn more, see How to Send Files Using MASV.

Only a MASV team owner or administrator may add a Cloud Integration and create a Portal. You only have to do this once to save files to S3.

Setting up Your S3 Bucket

Before you can receive files to save them to S3, make sure your bucket has an AWS access key with a policy that gives MASV the permission to use the s3:AbortMultipartUpload, s3:DeleteObject, s3:ListBucket, s3:GetBucketLocation, and s3:PutObject actions. You can do this in the Amazon Management Console.

Here’s an example of an AWS policy that gives MASV permission to save files anywhere in a bucket named second-unit:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:AbortMultipartUpload",
                "s3:DeleteObject",
                "s3:ListBucket",
                "s3:GetBucketLocation",
                "s3:PutObject"
            ],
            "Resource": [
                "arn:aws:s3:::second-unit",
                "arn:aws:s3:::second-unit/*"
            ]
        }
    ]
}

You can restrict access in your policy for convenience, to simply provide only relevant folders. Or you can do this for security, to limit access to specific folders. Here’s an example that limits access to save files in either the location-a or location-b folders in the second-unit bucket:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:ListBucket",
                "s3:GetBucketLocation"
            ],
            "Resource": [
                "arn:aws:s3:::second-unit",
                "arn:aws:s3:::second-unit/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:AbortMultipartUpload",
                "s3:DeleteObject",
                "s3:PutObject"
            ],
            "Resource": [
                "arn:aws:s3:::second-unit/location-a/*",
                "arn:aws:s3:::second-unit/location-b/*"
            ]
        }
    ]
}

Adding a Cloud Integration for Amazon S3

With your S3 bucket ready, you can use the MASV Web app to add a Cloud Integration.

To add a Cloud Integration to save to Amazon S3:

1. Log-in or sign-up into your MASV account.
2. Select Cloud Integrations in the left sidebar.
3. Select Add Integration then choose Amazon S3.
4. In Connection Name, give the integration a distinctive name.
   To make it easier to find later, fill in the domain you’ll use for your Portal.
5. Fill in Bucket, Access Key ID, and Secret Access Key for your S3 bucket.
6. Enable Save to Cloud.
7. Fill in Target Directory with the folder in the bucket that you want to save to.
   This is optional. But if your AWS policy limits access to specific folders in the bucket, then you must specify only one of these folders.
8. Select Connect.

Creating a Portal to Save to Amazon S3

With your S3 bucket and Cloud Integration, you can use the MASV Web app to create a Portal.

To create a Portal that saves to Amazon S3:

1. Select Portals in the left sidebar then select the + button to create a new Portal.
2. In the General and Look and Feel tabs, fill in the details for your Portal. See How do I Create a Portal.
3. In the Cloud Integrations tab, select the Cloud Integration you just created.
   You can select more than one integration that’s set up for storing files.
4. Select Create.
5. In the list of Portals, select the clipboard icon to copy the URL. 
   Now you can share the Portal URL with your collaborators. 

Sending Files Manually to Amazon S3

You can manually save files to Amazon S3 (or any other cloud integration) that you’ve sent or received. You can do this in the Web app’s Transfer History for any packages that haven’t expired.

To manually save a package to Amazon S3:

1. Select Transfer History then Sent or Received in the left sidebar.
2. Navigate to the package that you want to save.
3. In the dropdown menu in the Actions column, select Save Package to Cloud.
4. In the Select cloud integration dialog, choose your AWS S3 integration.
5. Select Confirm.
6. In the progress dialog, select Close.
   You can leave this page since the transfer happens in the cloud, not your web browser.