1. Help Center - MASV
  2. Apps & Integrations
  3. Receiving Portal deliveries automatically to cloud storage

How to connect to an Amazon S3 bucket

Integrate MASV with your Amazon S3 bucket

Amazon S3 from AWS (Amazon Web Services) is a cloud storage service known for providing scalability, data availability, security, and performance. If you have an Amazon S3 cloud storage bucket, follow the steps below to connect it to MASV.

You can create more than one Amazon S3 integration in MASV, mapping each integration to a specific Storage Class, transfer direction (save to S3 or send from S3), and Target Directory. You can then pair the integration with one or more MASV Portals to send or ingest files exactly where you want them.

How do I get Amazon S3 access keys?

Before you can integrate Amazon S3 with MASV, you need to have an access key for the Amazon S3 bucket you want to connect to. An access key consists of an Access ID and Secret Key. Access keys are created in the AWS Management Console.  

The Amazon S3 access key for MASV needs to be associated with an AWS user that has the permissions required for the MASV connection. When creating a permissions policy for MASV in AWS, the following "Actions" must be allowed to save to Amazon S3:

AbortMultipartUpload

DeleteObject

GetBucketLocation

ListBucket

PutObject

The following S3 Actions must be allowed to send from S3 via MASV:

GetObject

ListBucket

Here is an example of a policy statement for S3 (MASV save to S3):

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "masvintegration",
            "Effect": "Allow",
            "Action": [
                "s3:AbortMultipartUpload",
                "s3:DeleteObject",
                "s3:GetBucketLocation",
                "s3:ListBucket",
                "s3:PutObject"
            ],
            "Resource": [
              "arn:aws:s3:::<bucket name>",
              "arn:aws:s3:::<bucket name>/*"
            ]
        }
    ]
}

For information about creating policies for Amazon S3, see Policies and permissions in AWS.

For detailed information about how to create and manage Amazon S3 access keys, visit Manage access keys for IAM users

Information you'll need to have ready

To make the process go smoothly, have the following information on hand:

  • Amazon S3 bucket name
  • Region of bucket
  • Access key ID
  • Access key Secret
  • Know which AWS Storage Class you want to choose
  • Know your S3 path (which folder you want to connect with)

To integrate an Amazon S3 bucket with MASV

  1. In the MASV Web App, as a Team Owner or Admin (role), from the sidebar on the left, select Integrations.

  2. On the Integrations page, select the Available Integrations tab.

  3. Select Amazon S3.
  4. In the Add Integration window, enter or select the information required: 
    • Connection Name: Type a meaningful name. This name will display in the My Integrations list.

    • Bucket (Name of the Amazon S3)

    • Access Key ID: Copy and paste the AWS Access Key ID.

    • Secret Access Key: Copy and paste the AWS Secret.

    • Region: Choose the AWS Region for your bucket.
    • Storage Class: Choose from Standard, Glacier, Intelligent Tiering, One-Zone, and more.
    • Transfer Direction: Select one of the following options:
      • Save to storage: For inbound files (Write)--MASV transfers files to the storage device.

      • Send from storage: For outbound files (Read)--MASV transfers files out of the storage device.

5.  Choose any of the following optional settings:
    1. (Optional for Save to storage) In the Target Directory box, type a relative path. You will be able to edit this directory from the MASV Web App as needed.

    2. (Optional for Save to storage) In the Parent Folder Options, leave the checkbox unselected if you want to save the files in a directory that uses the package name. To deliver directly into the Target Directory, select the checkbox.

    3. (Optional for Send from storage) In Source Directories, type a relative path to limit access to a specific folder/directory. You will be able to edit this directory from the MASV Web App as needed.

6.  Select the Connect button.

7.  Refresh the page to update the list and status of the connections.

That's it! After authentication, the service is connected with MASV. You can now: