Integration: S3

About the S3 integration

When the S3 integration is set up, Brightcove creates an AWS S3 bucket that Audience Insights reports are automatically exported to on a daily or weekly basis (depending on the setup). One or more AWS admins in the customer Brightcove account are given access to the S3 bucket and can grant access to other users so that they can review the reports.

Overview

When you set up an integration with S3, data reports are automatically exported to an S3 bucket called reports.wicketlabs.com and available to be viewed or downloaded from there.

From Audience Insights, you can manually generate reports. If an S3 integration is set up, they can publish any of these reports to S3. You can also add users who can view/download the reports by applying the policy described below to other AWS users.

The reports will be exported to S3 on a daily or weekly basis, according to the schedule you set up, and will be available to those you given access by an admin on your AWS account (steps are shown below).

Requirements

• You must have an AWS account
• You must be an admin on a full Audience Insights account to set up the integration in Audience Insights

Integration setup in Audience Insights

1. Log in to the Scorecard and click the “gear” icon at the top right and then click “Settings”:

   

2. Scroll down until you see “Publish Integrations”. Click “+” to add integration. Choose “S3”:

   

   

3. Fill in the form with your AWS account Id, the publish frequency, and a contact email address which will receive a note if the publish process fails. Click “Create”.

   

Set up user permissions

Follow the steps below to set up user permissions to view the S3 bucket that reports are exported to.

Create policy

1. Log into your AWS account and navigate to the IAM page. From there click Policies, then Create Policy as shown below:

   

2. On the policy page, switch to the JSON policy editor and paste the following policy as shown in the image below:

   JSON for policy

   {
     "Version": "2012-10-17",
     "Statement": [
         {
             "Effect": "Allow",
             "Action": [
                 "s3:GetObject"
             ],
             "Resource": [
             "arn:aws:s3:::reports.wicketlabs.com/*"
             ]
         },
         {
             "Effect": "Allow",
             "Action": "s3:ListBucket",
             "Resource": "arn:aws:s3:::reports.wicketlabs.com"
         }
     ]
   }

   

3. Name the policy, add a description, and create the policy:

   

Attach policy to users

1. From the IAM page, click on the Users tab and select the user to be updated. From the user details page pictured below, click Add Permissions:

   

2. From the permissions page, click on the button to Attach existing policies directly. Use the filter to find the policy created earlier. Attach this policy and save the user. The user will now have access to the Wicket Labs report s3 bucket:

   

Viewing exported reports

Reports are stored in an S3 bucket located at s3://reports.wicketlabs.com/production/yourWicketLabsAccountId/. Reports can be accessed through the AWS console using the link provided in the Wicket Labs setting page. To locate the link, navigate to the settings page, edit the S3 publish integration, and click on the link as shown below: