Azure Storage 2.0.0
App Vendor: Microsoft
App Category: IT Services
Connector Version: 2.0.1
API Version: 12.19.1
About App
The Azure Storage app lets security teams integrate with the Azure Storage platform, offering scalable cloud storage for data, virtual machine disks, file systems, messaging, and NoSQL databases to securely manage and store data.
The Azure Storage app is configured with Cyware Orchestrate to perform the following actions:
Action Name | Description |
|---|---|
Create Blob | This action creates a new blob in Azure storage. |
Delete Blob | This action deletes a blob in the specified container. |
Download Blob | This action downloads the content of a blob and stores it in the local system. |
List Blobs in Container | This action retrieves the list of all the blobs in a container. |
List Containers | This action retrieves a list of containers. |
Update Blob | This action updates the content of a blob. |
Configuration Parameters
The following configuration parameters are required for the Azure Storage app to communicate with the 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: Create Blob
This action creates a blob in a container.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Data | Enter the content of the blob. | Text | Required | NoteFor the blob type PageBlob, ensure the content size is a multiple of 512 bytes. For more information, see Microsoft Azure Storage Documentation. |
Container Name | Enter the name of the container where the blob will be created. | Text | Required | You can retrieve container names using the action List Containers. |
Blob Name | Enter the name of the blob to create. | Text | Required | |
Blob Type | Enter the type of the blob to create. | Text | Optional | Allowed values: BlockBlob, PageBlob, AppendBlob. Default value: BlockBlob |
Extra Params | Enter the extra parameters to create a blob. | Key Value | Optional | Allowed keys: length, tags, content_settings, validate_content, lease, if_modified_since, if_unmodified_since, etag, match_condition, if_tags_match_condition, premium_page_blob_tier, standard_blob_tier, immutability_policy, legal_hold, maxsize_condition, max_concurrency, cpk, encryption_scope, encoding, progress_hook, timeout |
Example Request
[
{
"blob_name": "Sample Blob",
"blob_type": "BlockBlob",
"blob_content": "This is an example for sample content.",
"extra_params": {},
"container_name": "creatingblob"
}
]Action: Delete Blob
This action deletes a blob in the specified container.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Container Name | Enter the container name from which to delete the blob. Example: Sample container name | Text | Required | You can retrieve container names using the action List Containers. |
Blob Name | Enter the name of the blob to delete. Example: Sample Blob Name | Text | Required | You can retrieve blob names using the action List Blobs in Container. |
Extra Params | Enter the extra parameters to pass to the API. | Key Value | Optional | Allowed keys: delete_snapshots, version_id, lease, if_modified_since, if_unmodified_since, etag, match_condition, if_tags_match_condition, timeout |
Example Request
[
{
"blob_name": "Sample Blob Name",
"extra_params": {},
"container_name": "Sample Container Name"
}
]Action: Download Blob
This action downloads the content of a blob and stores it in the local system.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Container Name | Enter the container name that contains the blob. | Text | Required | You can retrieve container names using the action List Containers. |
Blob Name | Enter the blob name to download the contents. | Text | Required | You can retrieve blob names using the action List Blobs in Container. |
File Name | Enter a local file name to save the contents. | Text | Required | |
Extra Params | Enter the extra parameters to download the blob content. | Key Value | Optional | Allowed keys: version_id, validate_content, lease, length, if_modified_since, if_unmodified_since, etag, match_condition, if_tags_match_condition, cpk, max_concurrency, encoding, progress_hook, timeout |
Example Request
[
{
"blob_name": "Sample Blob Name",
"file_name": "page.txt",
"extra_params": {},
"container_name": "creatingblob"
}
]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. | Text | Required | You can retrieve container names using the action LIst Containers. |
Timeout | Enter the timeout value (in seconds) for the request. | Integer | Optional | Default value: 15 |
Extra Params | Enter the extra parameters to list blobs. | Key Value | Optional | Allowed keys: name_starts_with, include |
Example Request
[
{
"extra_params": {},
"container_name": "creatingblob"
}
]Action: List Containers
This action retrieves a list of containers.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Extra Params | Enter the extra parameters to pass to the API. | Key Value | Optional | Allowed keys: name_starts_with, include_metadata, include_deleted, include_system, results_per_page, timeout |
Action: Update Blob
This action updates the content of a blob.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Data | Enter the content to add to the blob. | Text | Required | NoteFor the blob type PageBlob, ensure the content size is a multiple of 512 bytes. For more information, see Microsoft Azure Storage Documentation. |
Container Name | Enter the name of the container where the blob is located. | Text | Required | You can retrieve container names using the action List Containers. |
Blob Name | Enter the name of the blob whose contents you want to update. | Text | Required | You can retrieve blob names using the action List Blobs in Container. |
Blob Type | Enter the type of the blob. | Text | Optional | Allowed values: BlockBlob, PageBlob, and AppendBlob Default value: BlockBlob |
Overwrite | Select true to overwrite the contents of the blob. If you choose false, the content is appended. | Boolean | Optional | Default value: false |
Extra Params | Enter the extra parameters to update the blob. | Key Value | Optional | Allowed keys: length, tags, content_settings, validate_content, lease, if_modified_since, if_unmodified_since, etag, match_condition, if_tags_match_condition, premium_page_blob_tier, standard_blob_tier, immutability_policy, legal_hold, maxsize_condition, max_concurrency, cpk, encryption_scope, encoding, progress_hook, timeout |
Example Request
[
{
"blob_name": "Sample Blob Name",
"blob_type": "BlockBlob",
"overwrite": false,
"blob_content": "This is the updated content.",
"extra_params": {},
"container_name": "creatingblob"
}
]