Publish assets using hosting services

Tutorial to publish assets using hosting services like Google Drive and Azure.

Overview

To publish assets on the Ocean Marketplace, publishers must provide a link(an URL) to the file. It is up to the asset publisher to decide where to host the asset. For example, a publisher can store the content on their Google Drive, AWS server, private cloud server, or other third-party hosting services. Through publishing, the URL of the asset is encrypted and stored as a part of DDO on the blockchain. Buyers don’t have access directly to the URL, but they interact with the Provider, which decrypts the URL and acts as a proxy to serve the asset. The DDO only stores the location of the file, which is accessed on-demand by the Provider. Implementing a security policy that allows only the Provider to access the URL and blocks requests from other unauthorized actors is recommended. One of the possible ways to achieve this is to allow only the Provider’s IP address to access the URL. But, not all hosting services provide this feature. So, the publishers must consider the security features while choosing a hosting service.

On Ocean Marketplace, a publisher must provide the link to the asset during publish step. Once the asset is published, this link cannot be changed. So, it is essential that the publisher correctly sets this field (shown in the below image).

Publish - File URL field
Publish - File URL field

Hosting services

Publishers can choose any hosting service of their choice. The below section explains how to use commonly used hosting services with Ocean Marketplace.

Google Drive

Google Drive allows users to share files/folders with various access policies. Publishers must set the access policy such that anyone with the link can download the file when using Ocean Marketplace with Ocean Protocol’s default Provider.

Open https://drive.google.com and upload the file you want to publish on the Ocean Marketplace. Right-click on the uploaded file and click the Share option. Set the file access policy correctly and click the Copy link button.

The file URL will be of the form https://drive.google.com/file/d/<FILE-ID>/view?usp=sharing, where the <FILE-ID> is the unique alphanumeric string. Verify if the URL is correct by entering it in a browser and check if the file is downloaded.

Google Drive link
Google Drive link

If you paste the copied URL into the browser, it will load an HTML page. Directly pasting the link on the publish page will publish the HTML page instead of a downloadable file URL. So, let’s make a downloadable file URL.

Note the <FILE-ID> from step 1 and create a URL as below.

https://drive.google.com/uc?export=download&id=<FILE-ID>

After creating a downloadable file URL, fill the File* field with the downloadable URL created in step 2.

Publish - Google Drive file
Publish - Google Drive file

Note: Google Drive allows only shared files to be downloaded, as shown in the above steps. The above method does not work with the shared folder. As a workaround, publishers can upload a zip of a folder and upload it as a file.


Azure storage

Azure provides various options to host data and multiple configuration possibilities. Publishers are required to do their research and decide what would be the right choice. The below steps provide one of the possible ways to host data using Azure storage and publish it on Ocean Marketplace.

Prerequisite

Create an account on Azure. Users might also be asked to provide payment details and billing addresses that are out of this tutorial’s scope.

Step 1 - Create a storage account

Go to Azure portal

Go to the Azure portal: https://portal.azure.com/#home and select Storage accounts as shown below.

Create a storage account - 1
Create a storage account - 1

Create a new storage account

Create a storage account - 2
Create a storage account - 2

Fill in the details

Add details
Add details

Storage account created

Storage account created
Storage account created

Step 2 - Create a blob container

Create a blob container
Create a blob container

Step 3 - Upload a file

Upload a file
Upload a file

Step 4 - Share the file

Select the file to be published and click Generate SAS

Click generate SAS
Click generate SAS

Configure the SAS details and click Generate SAS token and URL

Generate link to file
Generate link to file

Copy the link
Copy the link

Now, copy and paste the link in the Publish page in the Ocean Marketplace.

Publish the file as an asset
Publish the file as an asset

OneDrive

Create an account on Microsoft.

Step 1 - Upload a file

Go to OneDrive and upload the file to be published.

Upload a file
Upload a file

After the file is uploaded, right click on the file and click Embed, and copy the link.

Get an embeddable link
Get an embeddable link

Copy the highlighted content as shown in the below image:

Copy the iframe
Copy the iframe

The copied content has the following format:

<iframe src="https://onedrive.live.com/embed?cid=<CID>&
    resid=<RES_ID>%<NUMBER>&
    authkey=<AUTH_KEY>"
    width="98" height="120" frameborder="0" scrolling="no">
</iframe>

Copy the content from src field from the iframe. The link has the following format: https://onedrive.live.com/embed?cid=<CID>&resid=<RES_ID>%<NUMBER>&authkey=<AUTH_KEY>

Replace the https://onedrive.live.com/embed with https://onedrive.live.com/download from the above URL.

The downloadable file URL has the following format: https://onedrive.live.com/download?cid=<CID>&resid=<RES_ID>%<NUMBER>&authkey=<AUTH_KEY>

Enter the URL in the browser and verify if the file is downloaded correctly.

Copy and paste the link in the Publish page in the Ocean Marketplace.

Publish the file as an asset
Publish the file as an asset