Applies to
Explain what this how-to article is for. For example, you might write an article to teach people at your company how to set up a corporate email account or file an expense report.
example
The following how-to article describes how configure and add a AWS S3 to an existing Vidispine / Vidinet workflow solution.
Problem description
Is there an existing issue och workflow challenge? if so describe this story here and the customer will more easily recognize the understand the instructions.
example
Vidinet are not able to access a S3 Bucket.
Summary
Describe the goal of this how-article
example
Setting up MAM and distribution workflows using Vidinet and AWS S3Bucket as storage.
Summary
In the following how-to article you will learn how to configure an AWS S3 bucket for basic integration with Vidispine API / Vidinet. The steps described in this article will require
Also make a list of the pre-requisites, software, setup, , systems and not at least the knowledge required to use this how-to artice
example
...
.
AWS account with the necessary control over the permissions needed for integration with Vidispine/ Vidinenet- a basic Vidinet
Basic understanding of the AWS services such as S3 ( the cloud storage) and IAM ( the AWS permissions service )
an verified Verified installation of Vidispine API / Vidinet
a verified S3 bucket set up in your AWS account in order to attach this service to Vidinet
Try to divide the how-to article into defined sections in order for the user to more easily jump directly to the section of interest. The Headings 2 from now on will autotmatically be part of the table of contents!This how-to article describes a basic setup of an AWS bucket. For more advanced security and permission configuration of your AWS service to meet your companies requirements, please refer to AWS knowledge-base in the Related Articles below.
Table of contents
| Table of Contents |
|---|
Instructions
Create a step-by-step guide:
Add steps that are simple and self-contained
Add illustrations to instructions by typing /image
Stick to 3-5 steps per task to avoid overloading readers
Dont forget to rather show - than tell. Screenshots are use ful
Make sure to order the steps in chronological order to avoid confusion
examples
Setting up your AWS S3 bucket
To create a S3 bucket in AWS, direct your attention to the webpage of your AWS account and the Service S3.
click Click the Create Bucket button and follow the instructions prompted by AWS.
to create the subdirectories, click on your bucket and then click the button Create folder. Choose a name for the initial storage.
Repeat this process for the thumbnails directory.
In order for the S3 Bucket to be accessible for Vidinet a user needs to be created , or modified, to be allowed to use this resource. To grant permissions for the user to the S3 storage resource an AWS IAM Policy is used.
First, create a new user that should have permission to access this S3 bucket. Navigate to the AWS IAM Service. Click Users and then click then the button Add user. Follow the instruction prompted by the dialog dialogue box. Make sure to enable Programmatic Access to this users Access type.
< insert pictures>
< insert link to video>
Adding your AWS S3 to Vidinet.
if
Add User
...
During the user creation phase you will be prompted with the access key ID and secret access key
make sure to note these down in safe manner.
Configuring and adding permissions IAM
In order for this user to have access to the S3 resource you previously created, an IAM Policy needs to be set on this user. This can be done in several ways, one way is to use an inline policy for the user. Navigate to IAM Service once more, click Users and then click on the specific user you want to change permissions on. In our case this would be the user vidinet-user. Click the add inline policy button on the permissions tab for the user.
The permissions this user needs on the S3 resource objects are: GetObject, PutObject, DeleteObject and DeleteObjectVersion. For the S3 bucket itself the user needs: ListBucket and GetBucketLocation. Finally the user needs permission to list all buckets for this account: ListAllMyBuckets for all resources.
To achieve this enter the JSON tab on the inline policy and fill in the policy information. For us, this would look like the following:
| Code Block |
|---|
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "AllowUserToReadWriteObjectDataInBuckets",
"Effect": "Allow",
"Action": [
"s3:GetObject",
"s3:PutObject",
"s3:DeleteObject",
"s3:DeleteObjectVersion"
],
"Resource": [
"arn:aws:s3:::my-vaas-storage/*"
]
},
{
"Sid": "AllowListingOfBuckets",
"Effect": "Allow",
"Action": [
"s3:ListBucket",
"s3:GetBucketLocation"
],
"Resource": [
"arn:aws:s3:::my-vaas-storage"
]
},
{
"Sid": "AllowListingOfAllBuckets",
"Effect": "Allow",
"Action": [
"s3:ListAllMyBuckets"
],
"Resource": "*"
}
]
} |
After the storage, user and the policy has been created and updated we can proceed by filling in this information for the Vidispine as a Service setup.
Adding your AWS S3 Bucket to Vidinet.
After you have created your S3 bucket according to the previous chapter, the configuration of the S3 bucket integration to your Vidinet system should be quite straight forward from here.
During setup of your Vidispine as a Service, for instance, a Team Edition, you will be asked to configure an initial storage and a storage for thumbnails
...
You may choose to use different S3 buckets or simply use a single bucket with different subdirectories for storage or thumbnails.
| Info |
|---|
...
Storage can only be added through Vidinet dashboard GUI during VaaS launch. After that, the user needs to add storage or thumbnail resource through VS AP. |
Related articles
You can create links to external resources easily.
example
...
Getting started with VidinetThe content by label feature displays related articles automatically, based on labels you choose. To edit options for this feature, select the placeholder below and tap the pencil icon. ( You might need add more variables to this template )
| Page Properties | ||
|---|---|---|
| ||
|
...