Before you begin
Please ensure you have the following details ready to configure iconik with your Microsoft Azure General Purpose V2 or Blob Storage (your Azure administrator should be able to provide these if you don’t have them):
- Container Name - The container name. You can read more about how to create new container at Azure documentation page.
- Connection String - The connection string used to access the bucket. You can read more about connection string and where to find it at Azure documentation page. Only connection strings from the "Access Keys" tab work - SAS token–based connection strings do not.
If you are setting up a third party bucket we strongly recommend you read our knowledgebase article Controlling Costs as using iconik with third party buckets may cause costs for you.
Setup Permissions
The connection string you use need to have the necessary permissions to the container content and to the storage service itself to be able to set the CORS settings.
Azure has a limit on how many CORS rules can be added to a storage account. You can specify up to five CORS rules per storage service. Make sure you have space for one more before Azure storage is created on iconik.
Roles
These are the iconik roles that are needed:
- Owner
- read storage
- write storage
- reindex storage
Where to connect the storage
- Click on ADMIN in the top navigation.
- Choose Storages from the left navigation bar.
- In the + Connect Storage section, select the Azure Blob option from the list of available storages:
Connecting your Azure Storage
To successfully connect your Azure Blob storage to iconik, fill out the required fields presented in the guided step-by-step wizard. You can expand the Help pop out to provide more context as you complete each step.
Step 1 - Setup
- Enter the purpose of the storage you’re connecting:
- Files: stores all file types except keyframes and proxies.
- Keyframes: stores only keyframes generated by iconik.*
- Proxies: stores only proxies generated by iconik.*
- Exports: will be used as a destination for export jobs.
- Archive: will be used as an archive destination.
*Note: Adding your own keyframe and proxy storages will incur an additional monthly cost.
- Enter a unique name for your storage that will be easily recognizable for yourself and your team.
- Optional - enter a brief description of what this storage is used for.
- Enable or disable the available options:
- Read: this will allow iconik to read files on the storage.
- Write: this will allow iconik to write files to the storage.
- Delete: this will allow iconik to delete files on this storage. If this is enabled, files deleted from iconik will also be deleted from this storage.
- Add unique ID to filename: this will allow iconik to add a unique ID to each file within the storage, to avoid filename duplication.
- Select “Next” to continue.
Step 2 - Credentials
- Enter the name of the container you want to connect to.
- Enter the connection string that will allow iconik to connect to your storage.
- For file or archive storages, choose whether you will enable the ability for iconik to scan for new files on the storage.
- Optional - if Scan is enabled, you can enter specific scan directories to limit the scanning of these directories only.
- Recommended - If Scan is enabled, you can enable the Collection Directory Mapping toggle. This will automatically mirror the folder structure within your directory to a collection structure within iconik.
*Note: You can customize the scan settings after the storage is connected.
4. Optional - Select any of the transcoders that Iconik provides or have been set up previously by your team.
5. Select “Verify” to continue.
Step 3 - Verification
Iconik will verify the credentials that you have provided.
If verification is successful, please complete the process by selecting “Connect” and reviewing the storage settings. There may be some additional customization that you want to complete.
If verification is not successful, you can use the “Back” button to visit the previous steps and update the highlighted fields. If you’re making changes outside of iconik and want to run the verification process again, please choose “Retry”.
Next steps
Once you have successfully connected your Azure Blob storage, review the storage and scan settings available to ensure that is is configuration is optimized for your workflows.
Read next >> editing Azure Blob Storages