Microsoft Azure Storage
App Vendor: Microsoft
App Category: IT Services
Connector version: 1.0.1
API Version: 1.0.0
About App
The Microsoft Azure Storage platform is a cloud storage solution for modern data storage scenarios that offers a massively scalable object store for data objects, disk storage for Azure virtual machines (VMs), a file system service for the cloud, a messaging store for reliable messaging, and a NoSQL store. The Microsoft Azure Storage app allows security teams to connect with the enterprise version of Microsoft Azure Storage platform.
The Microsoft Azure Storage app allows security teams to connect to an instance of a Microsoft blob and perform actions such as listing, updating, and creating blobs. The Microsoft Azure Storage app is configured with the Orchestrate application to perform the following actions:
Action Name | Description |
|---|---|
List Blobs in Container | This action retrieves the list of all the blobs in a container. |
List Containers | This action retrieves the list of all the containers. |
Download Content of a Blob | This action downloads all the contents of a blob and stores them in the local system. |
Create Blob | This action creates a blob. |
Update Blob | This action updates the contents of a blob. |
Configuration Parameters
The following configuration parameters are required for the Microsoft Azure Storage app to communicate with the Microsoft Azure Storage enterprise application. The parameters can be configured by creating instances in the app.
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Connection String | Enter the connection string for authentication. Example* | Text | Required | To retrieve a connection string, you must either have a storage account set up or create a new one. While creating a storage account, provide the necessary details in the Basics tab, which includes Subscription, Resource group, Storage account name, and more. You can either customize the remaining settings according to your specific needs or use Microsoft’s default options. For more information, see Microsoft Azure Storage Documentation. To retrieve the Connection String from Azure Portal, go to Storage account > Security + networking > Access keys and click Show keys. In the key1 section, locate the Connection string value. |
Container Name | Enter a container name to test the connectivity and authentication credentials. Example: sample_container_name | Text | Required |
* Example:
DefaultEndpointsProtocol=https;AccountName=sampleaccountname;AccountKey=Eby8vdM02xNOcqFlqUwJPLlmEtlCDXJ1OUzFT50uSRZ6IFsuFq2UVErCz4I6tq/K1SZFPTOtr/KBHBeksoGMGw==
Action: List Blobs in Container
This action retrieves the list of all the blobs in a container.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Container Name | Enter the container name to get the list of blobs in a container. Example: sample_container_name | Text | Required | You can retrieve the Container Name using the List Containers action. |
Timeout | Enter the request timeout. Example: 10 | Integer | Required | Default value: 15 |
Example Request
[
{
"container_name": "sample_container_name"
"timeout" : "10"
}
]Action: List Containers
This action retrieves the list of all the containers.
Action Input Parameters
This action does not require any input parameter.
Action: Download Content of a Blob
This action downloads all the contents of a blob and stores them in the local system.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Container Name | Enter the container name that contains the blob. Example: sample_container_name | Text | Required | You can retrieve the Container Name using the List Containers action. |
Blob Name | Enter the blob name to download the contents. Example: sample_blob_name | Text | Required | You can retrieve the Blob Name using the List Blobs in Container action. |
File Name | Enter a local file name to save the contents. Example: sample_filename.txt | Text | Required |
Example Request
[
{
"blob_name": "sample_blob_name",
"file_name": "sample_filename.txt",
"container_name": "sample_container_name"
}
]Action: Create Blob
This action creates a blob in a container.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Blob Content | Enter the content of the blob to add in the blob. Example: sample_content | Text | Required | |
Container Name | Enter the name of the container to create a blob in the container. Example: sample_container_name | Text | Required | You can retrieve the Container Name using the List Containers action. |
Blob Name | Enter the name of the blob. Example: sample_blob_name | Text | Required | You can retrieve the Blob Name using the List Blobs in Container action. |
Blob Type | Enter the blob type. Example: AppendBlob | Text | Optional | Allowed values: BlockBlob, PageBlob, AppendBlob Default value: BlockBlob |
Example Request
[
{
"blob_name": "sample_blob_name",
"blob_type": "AppendBlob",
"blob_content": "sample_content",
"container_name": "sample_container_name"
}
]Action: Update Blob
This action appends content to an existing blob of type AppendBlob.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Blob Content | Enter the content of the blob to update the blob content. Example: sample_content | Text | Required | |
Container Name | Enter the container name that contains the blob. Example: sample_container_name | Text | Required | You can retrieve the Container Name using the List Containers action. |
Blob Name | Enter the blob name. Example: sample_blob_name | Text | Required | You can retrieve the Blob Name using the List Blobs in Container action. NoteEnsure that the Blob Name corresponds to an AppendBlob type. |
Example Request
[
{
"blob_name": "sample_blob_name",
"blob_content": "sample_content",
"container_name": "sample_container_name"
}
]