CafeX Virtual Storage Bucket – Microsoft Azure
The virtual storage bucket feature allows you to integrate virtual storage buckets created in Microsoft Azure with CafeX. By default, a storage space is allowed to each user of CafeX. However, to avoid any compliance issues or if one wants to handle the storage part internally, this feature comes in really handy.
To use this feature, you have to follow a number of steps so that your Microsoft Azure storage account is successfully linked with CafeX. Once this is done, all the assets you create in CafeX are stored in Azure and it also maintains the versioning of your assets.
Step 1: Create a Storage Bucket in Microsoft Azure
Upon successfully opening Microsoft Azure, navigate to the left-hand menu.
Click Storage Accounts. This opens the Storage Accounts screen where all the created storage accounts are listed.
Figure 1 Storage Accounts
To create a new one, click the +Create button listed atop the screen.
Figure 2 Create Button
This takes you to the Create Storage Account screen.
Here, enter the name of your storage account using the Storage Account Name field.
Figure 3 Storage Account Name
While creating an account, there are three key settings that you need to make sure are enabled.
Setting 1: Require Secure Transfer for REST API Operations Checkbox is Marked
For the first one, go to the Advanced tab from the tabs listed at the top.
Figure 4 Advanced
Navigate to the Security heading.
Here, confirm that the “Require secure transfer for REST API operations” checkbox is marked.
Figure 5 Require secure transfer for REST API Operations
Setting 2: Access Tier is set to Hot
On the same Advanced tab, navigate to the Blob Storage heading.
Under this heading, ensure that the Access Tier is set to Hot.
Figure 6 Access Tier set to "Hot"
Setting 3: Enable Versioning for Blobs
To enable this setting, open the Data Protection tab from the tabs listed at the top.
Figure 7 Data Protection
From here, navigate to the Tracking heading.
Make sure that the “Enable versioning for blobs” checkbox is marked. This enables you to record the versioning information of the asset versions you upload on CafeX to be recorded in Azure.
Figure 8 Enable Versioning for Blobs
Keep the default selections for the rest of the storage creation settings.
Click the Create button. This initializes the deployment and displays the “Deployment in Progress” screen.
Once successfully deployed, the created storage account is displayed on the same screen. Information is tabulated via a number of columns that include Resource, Type, Status, and Operation Details.
Figure 9 Deployment is in Progress
Once the deployment is complete, a success message is displayed. When this is done, click the Go to Resource button.
Figure 10 Go to Resource
Step 2: Getting the Access Keys for the Created Storage Account
When you click the Go to Resource button, the created storage account opens.
From the left-hand menu, click Access Keys.
Figure 11 Access Keys
The access key is what authorizes CafeX to communicate with the created Azure storage account.
From the Access Keys screen, copy the key displayed in the Key field. When you click the Show button next to this field, a copy to clipboard icon appears next to the access key.
Figure 12 Show
Figure 13 Copy to Clipboard
Step 3: Create a Container
A storage container is required for CafeX to access the created storage.
For that, navigate to the left-hand menu.
Under the Data Storage heading, click Containers.
Figure 14 Containers
From the Containers screen, click the +Container button.
Figure 15 Add Container
This opens the New Container popup in a panel on the right side of the screen.
Here, use the Name field to enter the name of the container.
Once the name is added, click the tick mark icon next to it to add the container.
Figure 16 New Container
The created container starts appearing in the Containers list.
Click the container name to have a detailed look into it.
Figure 17 Created Container
Here, all the assets in the container are listed. Information is tabulated via a number of columns that include Name, Modified, Access Tier, Archive Status, Blob Type, Size, and Lease State.
Figure 18 Created Container
Step 4: Link the Created Virtual Storage to CafeX
Upon successful login, click the three-dot icon from the top-right corner of the screen. Doing so reveals a list of options.
From these options, select Tenant Settings.
Figure 19 Tenant Settings
From the left-hand menu, click Data Storage located under the Configuration heading.
Figure 20 Data Storage
Once on the Data Storage screen, select Azure from the Type dropdown.
Figure 21 Azure
Enter the account name of the created Azure storage account in the Account Name field.
Figure 22 Account Name
Paste the access key you copied in the Account key field.
Figure 23 Account Key
Enter name of the container you created in Azure using the Container Name field.
Figure 24 Container Name
Once all the fields are filled, click the Update button.
Figure 25 Update
This displays a confirmation box notifying you that confirming this action will move all the assets created in CafeX to the Azure storage account.
To confirm the action, click the Confirm button.
Figure 26 Confirm Button
Step 5: Test the Created Storage Account Integration
Upon successful login, you land on the Apps screen where all the created apps are listed.
Select an app by clicking the app name.
Figure 27 Apps
From the app details screen, click the button located at the bottom-left corner.
Figure 28 Create a Workspace
This opens the Create Workspace popup.
Enter the name of the workspace in the Name field.
Figure 29 Name
Enter the topic of the workspace using the Topic field.
Figure 30 Topic
Enter a brief description of the workspace in the Description field.
Figure 31 Description
Select the template for the workspace using the Template dropdown.
Figure 32 Template
You can add users to this workspace using the Add People to this Workspace field. All the users you have added populate here.
Figure 33 Add People to this Workspace
If you want to keep this workspace private, enable the Private toggle.
Figure 34 Private
Once all the fields are filled, click the button.
Figure 35 Create Now
Once the workspace is created, click Assets from the tabs listed in the workspace. This opens the Assets tab.
From here, click Add Asset. This reveals a dropdown with a number of options to choose from.
Figure 36 Add Asset
Select Add File.
From the popup that appears, click Select Files. Doing so opens your system storage to upload a file from.
Figure 37 Select Files
Once the file is uploaded, it is displayed in the Assets tab.
Figure 38 Assets Tab
Now, switch back to the Containers screen in Microsoft Azure for your created storage account.
Click the Refresh button.
Figure 39 Refresh
The assets uploaded in CafeX start appearing in this container. This indicates that the integration is working smoothly.