MASV

Integration

To integrate Storj with MASV, you will need to create S3 credentials in Storj and add them within MASV.

Requirements

• An active Storj account
• A bucket for use with MASV in your Storj instance
• An active account on MASV

Create an Account

To begin, you will need to create a Storj account.

Navigate to https://www.storj.io/signup?partner=MASV to sign up, or log in https://storj.io/login if you already have an account.

Create a Bucket

Once you have your Storj account you can create a bucket for your data to be stored in.

1. Navigate to Browse on the left side menu.

2. Click on the New Bucket button.

3. Assign the bucket an easily identifiable name, such as "my-bucket".

4. Optional: Enable Object Lock (required for immutability in many applications).

   • If you enable Object Lock, you can also set a default retention period using either Governance or Compliance Mode

5. Optional: Enable Object Versioning (note that this will be enabled by default if Object Lock is enabled)

6. Click Create bucket

Generate S3 credentials

Storj has an Amazon S3 compatible API and you'll need generate S3 credentials to use it. S3 credentials consist of an access key, secret key, and endpoint.

Create S3 credentials in the Storj console:

1. Navigate to Access Keys on the left side menu.

2. Click the New Access Key button.

3. When the New Access dialog comes up, set specifications according to the following guidelines:

   • Name: The name of the credentials (e.g. my-access)
   • Type: S3 Credentials

4. Choose Full Access or Advanced

   • In most cases, you DO NOT want to choose full access.

5. Provide Access encryption Information

   In order to see the data uploaded to your bucket in the Storj console, you must unlock the bucket with the same encryption passphrase as the credentials.

   • Use the current passphrase: this is default option
   • Advanced: you may provide a different encryption phrase either your own or generate a new one.
     • Enter a new passphrase: use this option, if you would like to provide your own new encryption phrase
     • Generate 12-word passphrase: use this option, if you would like to generate a new encryption phrase

6. Select the permissions you want to allow:

   • Read
   • Write
   • List
   • Delete

7. Select the object lock permissions you want to allow

   • PutObjectRetention
   • GetObjectRetention
   • BypassGovernanceRetention
   • PutObjectLegalHold
   • GetObjectLegalHold
   • PutObjectLockConfiguration
   • GetObjectLockConfiguration

8. Choose the buckets you want the access to include:

   • All Buckets
   • Select Buckets

9. Set an expiration

10. Click Create Access to finish creation of your S3 credentials

11. Your S3 credentials are created. Write them down and store them, or click the Download all button. You will need these credentials for the following steps.

Object Lock Permission Details

Connecting MASV to Storj

Creating a Storj Cloud Integration in MASV

1. Log into your MASV Account:

2. In the MASV web app, select Integrations from the left-hand menu.

3. If you are using Cloud Integrations for the first time, click Storj from the grid; or you can also select Storj from the New Integration > Select Service drop-down menu.

4. In the pop-up window, fill out Connection Name. Tip: enter a short description of what you use this integration for. Fill out Bucket, Access Key ID, and Secret Access Key with the S3 credentials you created above.

5. After clicking Connect, you should be greated with a message confirming the integration.

Creating a MASV Portal integrated with Storj

1. In the MASV web app, select Request Files with Portals from the left-hand menu.

2. Select New Portal from the top right-hand corner.

3. In the Select New Portal pop-up window, select Custom Portal by clicking Create Portal.

4. On the Integrations tab, enable Storj by clicking its corresponding button in the Status column.

5. Continue to configure your portal as desired, finally clicking Create in the bottom right-hand corner.

6. Shortly after users upload content to MASV, the files should be available in your Storj bucket.