You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/en/docs/appstore/use-content/platform-supported-content/modules/azure/azure-blob-storage-connector.md
+25-9Lines changed: 25 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -40,13 +40,22 @@ After you install the connector, you can find it in the **App Explorer**, in the
40
40
41
41
### Configuring Authentication {#authentication}
42
42
43
-
In order to use the Azure Blob Storage service, you must authenticate using a Shared Access Signature (SAS) or an Azure Entra ID Access Token.
43
+
To interact with Azure Blob Storage, authentication can be performed using either a Shared Access Signature (SAS) or an Azure Entra ID Access Token.
44
44
45
45
#### SAS authorization
46
-
You or your admin needs to create a SAS for the container or blob you want to perform operations on. This SAS should then be added to a `SASCredentials` object on the `SASToken` attribute. Feed the `SASCredentials` object to the `AbstractCredentials` input parameter of the operation microflow you want to use.
46
+
A Shared Access Signature (SAS) provides secure, delegated access to resources in your storage account. Follow these steps:
47
+
48
+
1. Have your administrator generate a SAS for the target container or blob
49
+
2. Create a `SASCredentials` object and populate its `SASToken` attribute
50
+
3. Pass the `SASCredentials` object to the `AbstractCredentials` parameter in your operation microflow
47
51
48
52
#### Azure Entra ID Access Token
49
-
Set up SSO using the OIDC SSO marketplace module. When this is set up for your application you can use the `GetCurrentToken` microflow to get the access token needed for authenticationg the call. Create an `EntraCredentials` object and add the access token to the `BearerToken` attribute. Feed the `EntraCredentials` object to the `AbstractCredentials` input parameter of the operation microflow you want to use.
53
+
For Azure Entra ID authentication:
54
+
55
+
1. Configure Single Sign-On (SSO) using the `OIDC SSO` marketplace module
56
+
2. Utilize the `GetCurrentToken` microflow to obtain the required access token
57
+
3. Create an `EntraCredentials` object and set its `BearerToken` attribute
58
+
4. Supply the `EntraCredentials` object to the `AbstractCredentials` parameter in your operation microflow
50
59
51
60
### Configuring a Microflow for an AWS Service
52
61
@@ -55,19 +64,26 @@ You can implement the operations of the connector by using them in microflows. F
55
64
1. In the **App Explorer**, right-click on the name of your module, and then click **Add microflow**.
56
65
2. Enter a name for your microflow, for example, *ACT_PutBlob*, and then click **OK**.
57
66
3. In the **App Explorer**, in the **AzureBlobStorageConnector** section, find the **PUT_v1_Azure_PutBlob** operation microflow.
58
-
4. Create a **SASCredentials** or **EntrCredentials** object and add the SAS or access token to the **SASToken** or **BearerToken**attributes respectively.
67
+
4. Create a **SASCredentials** or **EntrCredentials** object and add the SAS or access token to the **SASToken** or **BearerToken**attribute.
59
68
5. Drag the **PUT_v1_Azure_PutBlob** microflow in to your microflow.
60
69
6. Double-click the **PUT_v1_Azure_PutBlob** operation to configure the required parameters.
61
70
62
71
For the `PUT_v1_Azure_PutBlob` operation, retrieve the `System.FileDocument` you want to store and provide a configured `SASCredentials` or `EntrCredentials` object. You must then create a `PutBlobRequest` object in your microflow as the last parameter. This entity requires the following parameters:
63
72
64
-
*`BlobName` - The BlobName attribute holds the name the blob will get in the Blob storage.
65
-
*`ContainerName` - The ContainerName attribute holds the target container name where the blob will be stored.
66
-
*`BlobType` - The BlobType attribute holds the type of blob that will be created. For now we only support the BlockBlob option.
73
+
| Parameter | Description | Required |
74
+
|-----------|-------------|----------|
75
+
|`StorageAccount`| Storage account name you want to perform Blob storage operations on | Yes |
76
+
|`VersionAPI`| API version for the Azure Storage service (e.g., '2021-04-01') | Yes |
77
+
|`BlobName`| Desired name for the blob in storage | Yes |
78
+
|`ContainerName`| Target container for blob storage | Yes |
79
+
|`BlobType`| Type of blob (currently supports BlockBlob only) | Yes |
67
80
68
81
The following parameters are optional:
69
-
*`ContentType` - Optional. The ContentType attribute can be used to specify the MIME content type of the blob. The default type is application/octet-stream.
70
-
*`StorageType` - Optional. The StorageType attribute specifies the storage tier to be set on the blob. For page blobs on a Premium Storage account only with version 2017-04-17 and later. For a full list of page blob-supported tiers, see https://learn.microsoft.com/en-us/azure/virtual-machines/disks-types#premium-ssd. For block blobs, supported on blob storage or general purpose v2 accounts only with version 2018-11-09 and later. Valid values for block blob tiers are Hot, Cool, Cold, and Archive. Note: Cold tier is supported for version 2021-12-02 and later. For detailed information about block blob tiering, see https://learn.microsoft.com/en-us/azure/storage/blobs/access-tiers-overview.
82
+
83
+
| Parameter | Description | Default |
84
+
|-----------|-------------|----------|
85
+
|`ContentType`| MIME content type specification | application/octet-stream |
86
+
|`StorageType`| Storage tier configuration | Varies by blob type |
71
87
72
88
9. Configure a method to trigger the `ACT_PutBlob` microflow.
73
89
For example, you can call the microflow with a custom button on a page in your app. For an example of how this can be implemented, see [Creating a Custom Save Button with a Microflow](/refguide/creating-a-custom-save-button/).
0 commit comments