How to connect Azure Blob Storage
This tutorial shows you how to give Dattos access to an Azure Blob Storage container so that processes can retrieve input files and deliver exported files to it. To learn about the integration as a whole, see File repositories: which ones Dattos connects to and how to set them up.
What you'll need
Access to the Azure portal with permission to view the storage account access keys (or someone on your cloud team who can do this).
The container must already exist in the storage account.
Dattos connects using the storage account access key. SAS tokens and Microsoft Entra ID sign-in are not supported. In the storage account, check under Settings › Configuration that Allow storage account key access is Enabled; if it is disabled, Azure will reject the connection. Since the key provides access to all the account's data, consider using a storage account dedicated to exchanging files with Dattos.
1. Create folders in the container
In a standard container, a folder is just the beginning of a file name: the folder exists as long as it contains at least one file, and an empty folder won't appear in Dattos' list. To create a folder:
In the portal, open the container and click Upload (Upload).
Under Advanced, enter the path in Upload to folder (Upload to folder), for example
entrada/extratos.Select the first actual file and upload it.
For the output folder, any file will do, because Dattos only writes to it and doesn't read what's already there. In the source folder, upload an actual file: everything in the source folder will be included in the next automatic run.
After the first run, the source folder will still exist even if there are no new files, because Dattos stores processed files in the .processed subfolder inside it. Storage accounts with hierarchical namespace enabled (Data Lake Storage) support empty folders by default.
2. Get the access details from the Azure portal
Open the storage account.
Note the storage account name, shown at the top of the page (for example,
empresafinanceiro).In the account menu, under Security + networking, select Access keys.
Click Show keys and copy the Key value for key1. Don't use the Connection string: Dattos only needs the key.
Under Data storage › Containers, note the container name.
To view the keys, your Azure user needs the Owner, Contributor, or Storage Account Key Operator Service Role role on that account.
If the storage account restricts access by network (Networking › Public network access set to Selected networks), ask Dattos Support for the addresses that need to be allowed.
3. Add the credential in Dattos
Click the gear icon and open General › Credentials.
Click + New credential and, on the Storage tab, select Azure Blob Storage.
Fill in the fields:
Field | What to enter | Required |
|---|---|---|
Credential name | A name that identifies the container, such as "Azure Finance - statements" | Yes |
Account | The storage account name, without | Yes |
Access Key | The key copied in step 2 | Yes |
Container | The container name | Yes |
Prefix | Optional. Limits Dattos to part of the container, for example | No |
Privacy profiles | Who can use this credential in processes | Yes |
Click Save.
Azure Blob Storage doesn't have a Test connection button. To verify access, follow the next step.
4. Verify and connect the container to a process
Open a Turbo AI process with a published flow and go to Source Directory.
Click Edit for the desired source, then click Add destination.
Under Storage Integration, select the credential you created.
If the container folders appear under Import Folders, access is set up correctly. Select the folder and save.
For the complete walkthrough, including output setup, see Integration with file repositories: source and output directories.
If you change the key in Azure
When you regenerate a key in Azure, the old key stops working immediately. To switch keys without interrupting processes, follow the order recommended by Microsoft:
Edit the credential in Dattos and paste key2 into Access Key.
In Azure, under Access keys, click Regenerate for key1.
Return to the credential in Dattos and paste the new key1.
Regenerate key2 in Azure.
How to view container files
Dattos shows folders, but not files. To check whether a file arrived, was moved to .processed or .error, or whether an export was delivered, open the container in the Azure portal (Data storage › Containers) or use Azure Storage Explorer, a free Microsoft application.
Common issues
What you see | Likely cause |
|---|---|
Error loading folders | Incorrect account name, key, or container; container doesn't exist; key changed in Azure; key access is disabled; or network access is blocked |
A folder doesn't appear in the list | The folder is outside the specified Prefix or doesn't exist in the container yet |