How to connect with your Iconik MAM

Step-by-step guide for integrating MASV with your Iconik system

Overview

Iconik is a Multimedia Asset Management (MAM) tool that can be used to gather and organize media from anywhere. When connected to your MASV Portal(s), you can receive large media files from anyone, anywhere at blazing fast speeds and have them delivered directly to your Iconik account. You can also collect metadata from a Portal and flow it through to Iconik.

Getting Started

First, you need an Iconik account that is connected to your cloud storage provider of choice (Azure, Backblaze B2, Google Cloud Storage, or AWS S3). You will need to create an Application Token in Iconik (contact your administrator if you do not have access to create this) before you can integrate MASV:

  1. Login to your Iconik account

  2. Click the Admin button

     

    Iconik admin dashboard

     

  3. Click on Settings from the left-hand menu to expand it then click Application Tokens

    Iconik dashboard icons

     

  4. Click the New Application button in the upper-right corner

    Iconik add new application

     

  5. Enter a name for the application and select a User that this token will belong to. This means that when MASV uploads files it will be acting on behalf of the user and will have their level of access; the user you select here must have read, write and delete authorization to upload files to your storage account, create jobs, initiate transcode operations, and must be a Power user. See the section below about Iconik Group Roles for more details.

    Iconik integration name and user name

     

  6. You will now see the application in the list, but you will need to clinic the Create New button next to it to generate the token you will need to provide to MASV.

    Iconik create new button

     

  7. You will need to click the button beside Copy Token to copy the Application Token AND click the button at the far right under ID to copy the Application ID - both are necessary for connecting MASV so be sure to save both somewhere safe.

    Iconik application token

Iconik Group Roles

The user that the application token is associated with must belong to a group with specific roles enabled OR be an Admin user to ensure that MASV will have the necessary access to transfer your files. They must be a Power user to ensure that package metadata can be added to each asset.

  1. Login to your Iconik account

  2. Click the Admin button

    Iconik admin button

     

  3. Click on Groups from the left-hand menu and either edit an existing group or create a new one.

    Iconik group button

     

  4. Under Group Information toggle Roles - Advanced View. The following permissions must be enabled (others can be enabled too, these are the minimum):

    1. Assets - create, delete, purge and write

    2. Collections - create, delete, purge, read and write

    3. Files - delete, purge, read and write

    4. Formats - create and write

    5. Jobs - delete and write

    6. Metadata fields - read and write

    7. Metadata views - read and write

    8. Storages - read

    9. Transcode jobs - create

      Iconik advance role dashboard
  5. Click update once you’ve added any that were previously unchecked and you’re done!

Setup MASV with your Iconik Application Credentials

MASV integration with MASV
  1. Login to you MASV account

  2. Browse to Cloud Integrations and click Add Integration

  3. In Select Service choose Iconik

  4. Paste in the Application ID and Application Token you generated in Iconik

  5. From the Storage Account selector, locate the cloud storage you want MASV to store your files in. Note: MASV requires read, write and delete permissions on the storage account. If the storage you wish to use does not appear in this list, please refer to the section below for details on required configuration for storage accounts.

  6. Click Connect to save your settings

Now you can attach your cloud integration to your MASV Portal(s) to have your uploads automatically transferred to Iconik. You may also select this integration to upload individual packages using the Send to Cloud feature on the Packages list pages.

Connecting a MASV Portal

To attach a cloud integration to a MASV Portal, simply do the following

  1. Login to you MASV account

  2. Browse to Portals and edit the portal you wish to integrate to Iconik

  3. Under Deliver to Cloud click Select Integrations

  4. Locate the Iconik integration you wish to use, close the popup and click Update Portal

Note: the email address(es) in the Recipients field will receive a notification when new packages are uploaded to Iconik.

How it works

When a package is uploaded to a connected MASV Portal or the Send to Cloud feature is used from the package list, MASV will transfer the package to Iconik and the connected storage account.

  • In MASV:

    • Portal recipients receive an email with a download link as well as a second email indicating the status of the transfer to Iconik

    • A message is published to a connected Slack channel to indicate the transfer status to Iconik

  • In Iconik:

    • A collection is created and named for the package, with each file organized within it.

      • Send to cloud: /MASV/[package name]

      • Received portal uploads: /Portal Downloads/[portal name]/[package name]

    • The package structure is replicated, with each folder being represented as a collection.

    • A job is created for each file so that you may monitor the progress within Iconik’s Admin panel if you wish.

    • Each file will have a keyframe (preview thumbnail) generated for it automatically.

    • The package name, uploader’s email address and portal name (if received via portal) will be attached to the description field of each file asset.

  • In the cloud storage account:

    • A directory is created and named for the package, with each file organized within it.

      • Send to cloud: /MASV/[package name]

      • Received portal uploads: /Portal Downloads/[portal name]/[package name]

    • The package file and folder structure is replicated as-is.

Note: empty subdirectories are not recreated in Iconik or the cloud storage account.