Skip to main content

Azure Blob Setup Guide

Prerequisites

  • An Azure Storage account with a Blob container holding your files
  • Access to the Azure Portal with permission to grant read and list access to that container:
    • Connection String: permission to create Shared Access Signatures on the storage account
    • Client ID And Secret: permission to register apps in Microsoft Entra ID and to assign roles on the container

Step 1 (Authentication with Connection String): Generate a Connection String

  1. Open the Azure Portal and navigate to your Storage account.

  2. In the left navigation pane, click Shared access signature.

  3. Under Allowed services, select Blob.

  4. Under Allowed resource types, select Container and Object.

  5. Under Allowed permissions, select Read and List.

    • Read: to read file contents
    • List: to enumerate files in the container
  6. Set appropriate Start and Expiry dates for the SAS token.

    Note: When the SAS expires, you will need to update the connector with a new connection string to resume syncing.

  7. Under Allowed protocols, select HTTPS only.

  8. Click Generate SAS and connection string.

  9. Copy the Connection string value. You will need it in Step 2.

Step 2 (Authentication with Client ID And Secret): Create a Microsoft Entra ID App

Register the app

  1. Open the Azure Portal and go to Microsoft Entra ID > App registrations.
  2. Click New registration.
  3. Enter a name for the app (e.g., matia-azure-blob), select the supported account types, and click Register.
  4. On the app's Overview page, copy:
    • Application (client) ID: this is your Client ID
    • Directory (tenant) ID: this is your Tenant ID

Create a client secret

  1. In the app, go to Manage > Certificates & secrets.
  2. Click New client secret, add a description, choose an expiration period, and click Add.
  3. Copy the your Client secret - you will need it to configure your connection in Matia, and Azure will not show it again.

Find the storage account name

  1. Go to Storage accounts and select the storage account that holds your container.
  2. Copy the Storage account name.

Grant the app access to the container

  1. In the storage account, go to Storage browser > Blob containers and select the container you want to sync.
  2. In the container, open Access Control (IAM) and click Add > Add role assignment.
  3. Select the Storage Blob Data Reader role and click Next.
  4. Under Assign access to, select User, group, or service principal, click Select members, and select the app you registered.
  5. Click Review + assign.

Step 3: Complete Configuration in Matia

  1. Select your Authentication Method: Connection String or Client ID And Secret.
  2. Enter the Container name.
  3. Enter your credentials:
    • Connection String: Paste the Connection String you generated in Step 1A.
    • Client ID And Secret: Enter the Storage account name, Tenant ID, Client ID, and Client secret from Step 1B.
  4. (Optional) Enter a Base Folder Path within the container to scope the sync, e.g., exports/data.
  5. Enter an Asset Name.
  6. (Optional) Enter a Description.
  7. (Optional) Assign Tags.
  8. Select an Owner.
  9. Verify that your Azure Blob account is successfully connected by clicking on Test Connection.
  10. Click Connect.