Aspera on Cloud

Introduction

IBM Aspera on Cloud is a cloud-based data transfer service that enables high-speed, secure, and reliable transfer of large files and data sets over the internet. It uses advanced encryption and data compression techniques to transfer data quickly and securely, regardless of the distance or network conditions.

Aspera on Cloud is designed for businesses of all sizes and industries, including media and entertainment, healthcare, and government.

IBM Aspera on Cloud provides a web-based interface and RESTful APIs that enable easy integration with other cloud-based applications and services. It also offers advanced features such as bandwidth control, file verification, and automatic retry to ensure efficient and secure transfer of large files and data sets.

You can find more details and the supported operations on Aspera on Cloud | qibb Catalog.

How to get started with Aspera on Cloud integration

Before you get started with the Aspera on Cloud integration, please make sure that you have the needed permissions for those operations. Here you can find Aspera on Cloud API Documentation.

1. You need an Email address which is used to sign in to Aspera on Cloud, Organization ID, API Client ID, Client Secret, a Private key and a Public key for authentication.

2. You can find your Organization ID in the URL of your Aspera on Cloud dashboard (e.g. orgname1234.ibmaspera.com).

   

3. To generate an API Client Id and Client Secret click on the App Switcher button in the top right corner and then click on the Admin button.

   

4. On the Admin page, click on the Integrations, API clients and Create new buttons to create a new API client.

   

5. Give a name to your API client. Type “blank“ as a redirect URI and save it. Then enable JWT grant type and click on the Create button.

   

6. Once you click on the Create button, your API Client ID and Client secret will be generated.

   

7. For authenticating Aspera on Cloud, you need to generate a Private key and a Public key locally. You could use openssl to generate Private-Public key pairs. Here you can find information about how to generate Private and Public keys: Configuring for Aspera on Cloud.

8. Once you have generated Private and Public keys, you need to enter your Public key in the relevant field in your account settings. Go to the Account Settings by clicking the User button in the top right corner.

   

9. Scroll down the page, enter your Public key in the relevant field and click on the Save button.

   

10. Go to qibb Workflow Editor, open Node Catalog in the right sidebar, and install Aspera on Cloud node by clicking on the + button.

11. Drag Aspera on Cloud API and Aspera on Cloud Auth node from the left sidebar and place them in your flow.

12. Open the Aspera on Cloud Auth node, enter your Email address, Organization name, API Client ID, Client Secret and Private key, select an operation in the Aspera on Cloud node and start using the integration!

    

Get started with Aspera Node API integration

If you want to use Aspera Node API node, make sure that you have a valid Access Key and a Secret Key.

1. Aspera sends the Access Key and Secret as a txt file into Packages.

   

2. Redirect to the Packages page and download the txt file. You will find the Access Key and Secret in this file.

   

3. Drag Aspera Node API nodes from the left sidebar and place them in your flow.

4. Enter your Access Key as Username and your Secret Key as Password into the Advanced/Security field of the node. Now you are ready to start using the integration.

   

For Aspera Node API integration it is not necessary to use the authentication node. Aspera Node API uses the basic authentication method and it is sufficient to enter Access Key and Secret Key into the Advanced/Security section.

Importing flow examples of a node

Once you've successfully installed a node from the qibb catalog, you can easily import example flows that showcase how the nodes can be used. These example flows are directly accessible within the Flow Editor and are designed to guide users with helpful hints, including how to configure mandatory parameters and credentials.

Here's how to import examples:

1. In the top right corner of the Flow Editor, click on the menu icon.

2. Select Import to open the Import Dialog.

3. Click on the Examples tab.

4. Choose an example from the list.

5. Confirm your selection by clicking on the Import button.

By following these steps, you are now ready to make basic API calls using the provided examples. For further exploration of what’s possible, you can find more complex examples in the Flow Catalog.