Azure Setup Steps

Step 1: Create an Azure Storage Account

1. Log in to the Azure Portal: Go to Azure Portal.
2. Navigate to Storage Accounts: In the left-hand navigation pane, search for Storage Accounts and select it.
3. Create a New Storage Account:
   • Click on + Create.
   • Subscription: Select the Azure subscription to use.
   • Resource Group: Select an existing resource group or create a new one.
   • Storage Account Name: Enter a globally unique name for your storage account.
   • Region: Choose the region where you want to host your storage account.
   • Performance: Choose between Standard and Premium, depending on your performance needs.
   • Replication: Select the redundancy option (e.g., LRS, GRS) based on your data durability requirements.
   • Click Review + Create, and then Create.
4. Wait for Deployment: Once the deployment is complete, you’ll be able to access the newly created storage account.

Step 2: Create a Blob Storage Container

1. Go to Your Storage Account: Once the storage account is created, go to it in the Azure Portal.
2. Navigate to Blob Service: Under Data Storage, select Containers.
3. Create a New Container:
   • Click + Container.
   • Name: Enter a name for your container (e.g., fileuploads).
   • Public Access Level: Choose the desired access level (Private or Blob).
   • Click Create.

Step 3: Generate a Shared Access Signature (SAS) Token

1. Go to Shared Access Signature: In the Security + Networking section of your storage account, select Shared access signature.
2. Set Permissions: Enable the necessary permissions for the SAS token:
   • Permissions: Enable Read, Write, Delete as required.
   • Allowed Services: Enable Blob.
   • Allowed Resource Types: Enable Object.
3. Set Expiry and Start Times: Configure the validity period for your SAS token.
   • Start Time: Set the start time.
   • Expiry Time: Set the expiry date/time.
4. Generate SAS Token: Click on Generate SAS and Connection String, copy the generated SAS token, and store it in a notepad.

The generated SAS token will include several parameters, such as:

• sv (Service version)
• ss (Service)
• srt (Resource type)
• sp (Permissions)
• se (Expiry time)
• st (Start time)
• spr (Protocol)
• sig (Signature)

OutSystems Component Setup

Step 1: Install the Component

1. Download the Component: Access the OutSystems Forge and download the Azure Blob Storage Component.
2. Install the Component: In OutSystems Service Studio, navigate to the "Forge" tab, search for "Azure Blob Storage Component," and click Install.
3. Add to Your Application: Include the component in your OutSystems application by adding a reference to it.

Step 2: Configure SAS Token and API Integration

1. Open Your Application Module: In OutSystems, open the application where you’ll be integrating Azure Blob Storage.
2. Configure SAS Token, Container Name, and Base URL:
   • SAS Token: Set the SAS token as a setting (ODC). This token will be automatically included in the API call as query parameters such as sv, ss, srt, sp, se, st, spr, and sig.
   • Container Name: Store the container name as a settings (ODC), making it easily configurable without changing the application logic.
   • Base URL: Define the base URL for Azure Blob Storage as a settings (ODC). For example: https://.blob.core.windows.net. Please note that if you are using Azure Gov Cloud, the URL format will be different.
3. Pass File Parameters:
   • FileName: The file name will be passed as part of the URL in the API request.
   • FileData: The binary file data will be passed as a body parameter in the API request.

Support

For support or issues, please reach out to Cloud And Things or contact the contributor, Smit Shiroya.