Integrate Iconik with Backblaze B2
    • Dark
      Light

    Integrate Iconik with Backblaze B2

    • Dark
      Light

    Article summary

    iconik is a powerful cloud-based media asset management (MAM) solution that lets you make your content that is stored in Backblaze B2 Cloud Storage fully intractable through a web browser. This guide provides the steps to add a Backblaze B2 bucket that contains your media into iconik. Once linked, iconik scans the media resources that you have in your bucket, transcodes them into web proxies, and displays them in a searchable catalog.

    Enable Backblaze B2

    Before you begin: You must have a Backblaze B2 Cloud Storage account. You can sign up here. If you already have a Backblaze account and the left navigation menu contains a B2 Cloud Storage section, your account is already enabled for Backblaze B2.

    1. Sign in to your Backblaze account.
    2. In the left navigation menu under Account, click My Settings.
    3. Under Enabled Products, select the checkbox to enable B2 Cloud Storage.
    4. Review the Terms and Conditions, and click OK to accept them. 

    Create a Bucket

    1. Sign in to your Backblaze account.
    2. In the left navigation menu under B2 Cloud Storage, click Buckets.
    3. Click Create a Bucket.
    4. Enter a name for your bucket.
      Bucket names must be at least six characters and globally unique. A message is displayed if your bucket name is already in use.
    5. Select a privacy setting: Private or Public.
      Files that are in a private bucket require authentication to perform an action, for example, downloading. Public buckets do not require authentication so you can easily share files. You can change a bucket's privacy settings at any time.
    6. If applicable, enable a Backblaze B2 server-side encryption key.
    7. Enable Object Lock to restrict a file from being modified or deleted for a specified period of time.
    8. Click Create a Bucket, and copy the value that is in the Endpoint field; you may need this value for other processes.
    9. Click Lifecycle Settings to control how long to keep the files in your new bucket.

    Create an App key

    For this integration, select Read and Write in the Type of Access field.

    Application keys control access to your Backblaze B2 Cloud Storage account and the buckets that are contained in your account.

    1. Sign in to your Backblaze account.
    2. In the left navigation menu under Account, click Application Keys.
    3. Click Add a New Application Key, and enter an app key name.
          You cannot search an app key by this name; therefore, app key names are not required to be globally unique.
    4. Select All or a specific bucket in the Allow Access to Bucket(s) dropdown menu.
    5. Optionally, select your access type (Read and Write, Read Only, or Write Only).
    6. Optionally, select the Allow List All Bucket Names checkbox (required for the B2 Native API b2_list_buckets and the S3-Compatible API S3 List Buckets operations).
    7. Optionally, enter a file name prefix to restrict application key access only to files with that prefix. Depending on what you selected in step #4, this limits application key access to files with the specified prefix for all buckets or just the selected bucket.
    8. Optionally, enter a positive integer to limit the time, in seconds, before the application key expires. The value must be less than 1000 days (in seconds).
    9. Click Create New Key, and note the resulting keyID and applicationKey values.
    Note
    When you create a new app key, the response contains the actual key string, for example N2Zug0evLcHDlh_L0Z0AJhiGGdY. You can always find the keyID on this page, but for security, the applicationKey appears only once. Make sure you copy and securely save this value elsewhere.

    Add a Storage Type

    1. Sign in to iconik, click ADMIN in the upper navigation menu, and click Storages in the left menu. 
    2. Click NEW STORAGE, and add storage details.
      1. Enter a name for your storage.
      2. Enter a description.
      3. Select a storage purpose depending on your particular needs. If you use the bucket for active media data that you will import into iconik, select Files.
      4. Select Backblaze B2 as the storage type.
      5. Enter your Backblaze B2 keyID and applicationKey.
      6. Enter your bucket name and bucket ID.
      7. Enter the path. If the directory that contains media is nested, indicate that using in this Path setting.
      8. Enable permissions for your integration. If you need iconik to generate proxies, select Enable Scan.
      9. Optionally, set the scan directories so that iconik knows that the specific directory contains files that should be transcoded. 
    3. Click OK.
      Green check marks indicate that iconik was able to communicate with the Backblaze B2 bucket.

    Generate a Web Proxy

    You can use the iconik transcoders to generate web proxies by modifying the scan settings to allow iconik to automatically scan and index data. This is convenient if the bucket is actively getting new data that needs to be added to iconik.

    1. Select the Scan settings tab. 
    2. Turn on the toggle for Enable Scan.
    3. Turn on the toggle for Auto Scan, and set this value to an interval that works for your integration.
    4. Select the Transcoders tab to set up and configure transcoders.
    5. Select the Transcode settings tab, and set the transcoder that you want to use for the bucket scans.
    6. Select the Search tab to browse and view the media data that is in your Backblaze B2 bucket.

    Was this article helpful?