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
-
Open the Azure Portal and navigate to your Storage account.
-
In the left navigation pane, click Shared access signature.
-
Under Allowed services, select Blob.
-
Under Allowed resource types, select Container and Object.
-
Under Allowed permissions, select Read and List.
- Read: to read file contents
- List: to enumerate files in the container
-
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.
-
Under Allowed protocols, select HTTPS only.
-
Click Generate SAS and connection string.
-
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
- Open the Azure Portal and go to Microsoft Entra ID > App registrations.
- Click New registration.
- Enter a name for the app (e.g.,
matia-azure-blob), select the supported account types, and click Register. - 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
- In the app, go to Manage > Certificates & secrets.
- Click New client secret, add a description, choose an expiration period, and click Add.
- 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
- Go to Storage accounts and select the storage account that holds your container.
- Copy the Storage account name.
Grant the app access to the container
- In the storage account, go to Storage browser > Blob containers and select the container you want to sync.
- In the container, open Access Control (IAM) and click Add > Add role assignment.
- Select the Storage Blob Data Reader role and click Next.
- Under Assign access to, select User, group, or service principal, click Select members, and select the app you registered.
- Click Review + assign.
Step 3: Complete Configuration in Matia
- Select your Authentication Method: Connection String or Client ID And Secret.
- Enter the Container name.
- 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.
- (Optional) Enter a Base Folder Path within the container to scope the sync, e.g.,
exports/data. - Enter an Asset Name.
- (Optional) Enter a Description.
- (Optional) Assign Tags.
- Select an Owner.
- Verify that your Azure Blob account is successfully connected by clicking on Test Connection.
- Click Connect.