> ## Documentation Index
> Fetch the complete documentation index at: https://explore.airia.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Azure Blob

# Set Up the Azure Blob Connector

The Azure Blob Data Connector allows you to ingest documents from your Azure Blob Storage into your project.

## Prerequisites

To use the Azure Blob connector, you will need either:

* **For Storage Access Key authentication:**
  * An Azure Storage Account **Connection String**.
  * The **Container Name** within your Azure Storage Account from which you want to ingest data.
  * You will need to have created a container in your Azure Blob and uploaded your files there.
* **For Shared Access Signature (SAS) authentication:**
  * A **Shared Access Signature (SAS) URL** for your Azure Blob container.
* You can find these details in your Azure Portal under your storage account.

## Steps

1. **Select Azure Blob Data Source**
   Navigate to the **Data Sources** section of your project. Click **Add data source** and select **Azure Blob** from the available library.
2. **Provide Connection Details and Choose Authentication Method**
   Choose your preferred authentication method and provide the corresponding details:

   ### Option 1: Storage Access Key Authentication

   This method requires your storage account's connection string and the container name.

   1. **Select Authentication Method:** Choose the **Storage Access Key** option when setting up the connector.
   2. **Locate Credentials:**
      * In your Azure Portal, navigate to your Azure Blob Storage account.
      * Go to **Access Keys** under the **Security + networking** section.
      * Save the **Connection String** from one of the keys (e.g., `key1` or `key2`).
   3. **Enter Details:**
      * **Connection String**: Paste the saved connection string.
      * **Container Name**: Enter the exact name of the container you wish to ingest.

   <Warning>
     Ensure you provide the correct container name to synchronize the intended content.
   </Warning>

   ### Option 2: Shared Access Signature (SAS) Authentication

   This method uses a generated Shared Access Signature (SAS) URL for granular access.

   1. **Select Authentication Method:** Choose the **Shared Access Signature (SAS)** option when setting up the connector.
   2. **Generate SAS URL:**
      * Go to your Azure Blob account in the Azure Portal and select the desired storage account.
      * Navigate to **Containers** and select the specific container you want to sync.
      * Click on **Shared access tokens** or **Generate SAS**.
      * Configure the SAS token with an appropriate **expiration time** and **permissions** (ensure read and list permissions are granted for ingestion).
      * Click **Generate SAS token and URL**.
   3. **Enter Details:**
      * **Connection URL**: Copy and paste the generated Shared Access Signature (SAS) URL.
3. **Monitor Ingestion Status**\
   Once you provide your connection details, the page will refresh to display the ingestion status. You can view the current ingestion status by clicking on the data source again.

<Note>
  Ingestion can take some time depending on the volume of data.
</Note>

## Next Steps

After your data has been successfully ingested, the Azure Blob data source is ready to be used with an Agent.