> For the complete documentation index, see [llms.txt](https://docs.couchdrop.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.couchdrop.io/storage/integrations/azure-files.md).

# Azure Files

Learn how to configure a connection to Azure Files with Couchdrop

## Overview

Connect Azure Files to Couchdrop to use an existing Azure file share with your file transfer workflows.

Once connected, your Azure Files storage is available through Couchdrop for transferring files to and from the underlying file share.

## How to connect Azure Files

{% hint style="warning" %}

#### Before you start

To connect Azure Files, you will need:

* An Azure **Account Name**
* An Azure **Secret Key**
* An Azure **Share Name**

You can find more information about managing Azure Storage accounts in the [Microsoft Azure documentation](https://docs.microsoft.com/en-us/azure/storage/common/storage-account-manage).
{% endhint %}

{% stepper %}
{% step %}

### Add a new Azure Files connection

In Couchdrop, add a new storage connection and select **Azure Files** from the available storage providers.
{% endstep %}

{% step %}

### Configure Azure Files

Enter a **Name for this integration** and select the **Couchdrop folder path** where the connection will appear.

Enter your Azure Files details:

* **Azure Account Name** — Enter the name of your Azure Storage account.
* **Azure Account Key** — Enter the account key for your Azure Storage account.
* **Azure Share Name** — Enter the name of the Azure file share you want to connect to.
* **Endpoint Suffix** — Optionally enter a custom Azure endpoint suffix.

When the connection details are complete, select **Save and Test**.
{% endstep %}

{% step %}

### Select a folder

After the connection has been tested, you can optionally select a specific Azure Files location to map into Couchdrop.

Leaving this blank allows Couchdrop to map the storage connection directly without restricting it to a specific folder.

You can select a location using the folder browser or manually enter a path.
{% endstep %}

{% step %}

### Save and use your Azure Files connection

Optionally, configure **Transfer Shield** and select a content rule group to surface or block unexpected, non-compliant, or malicious files uploaded through this connection.

When the configuration is complete, save the integration.
{% endstep %}
{% endstepper %}