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

# Amazon S3

> Connect BonData to Amazon S3 buckets

Amazon S3 (Simple Storage Service) is AWS's highly scalable, durable object storage for any type of data. With BonData, you can connect to your S3 buckets to read CSV, JSON, and Parquet files directly into your workflows - enabling analysis and enrichment of data stored in AWS.

## S3 Connection Setup

Follow these steps to connect BonData to your S3 bucket.

### Step 1: Create an IAM User

1. Go to the [AWS IAM Console](https://console.aws.amazon.com/iam/)
2. Click **Users** → **Create user**
3. Enter a name (e.g., `bondata-s3-access`)
4. Click **Next** → **Attach policies directly**
5. Click **Create policy** and use one of the policies below

### Step 2: Choose a Policy

<Tabs>
  <Tab title="Specific Folder (Recommended)">
    ```json theme={null}
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": ["s3:ListBucket"],
          "Resource": "arn:aws:s3:::YOUR_BUCKET_NAME",
          "Condition": {
            "StringLike": {
              "s3:prefix": "YOUR_PREFIX/*"
            }
          }
        },
        {
          "Effect": "Allow",
          "Action": ["s3:GetObject", "s3:PutObject"],
          "Resource": "arn:aws:s3:::YOUR_BUCKET_NAME/YOUR_PREFIX/*"
        }
      ]
    }
    ```
  </Tab>

  <Tab title="Full Bucket Access">
    ```json theme={null}
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Effect": "Allow",
          "Action": ["s3:ListBucket"],
          "Resource": "arn:aws:s3:::YOUR_BUCKET_NAME"
        },
        {
          "Effect": "Allow",
          "Action": ["s3:GetObject", "s3:PutObject"],
          "Resource": "arn:aws:s3:::YOUR_BUCKET_NAME/*"
        }
      ]
    }
    ```
  </Tab>
</Tabs>

<Note>
  Replace `YOUR_BUCKET_NAME` and `YOUR_PREFIX` with your actual values.
</Note>

### Step 3: Create Access Keys

1. Go to your new user → **Security credentials** tab
2. Click **Create access key**
3. Select **Third-party service** → **Next**
4. Copy the **Access Key ID** and **Secret Access Key**

### Step 4: Enter Credentials

Enter the Access Key ID and Secret Access Key in BonData.

## Required Fields

| Field             | Description                                        |
| ----------------- | -------------------------------------------------- |
| Bucket Name       | The name of the S3 bucket (e.g., my-data-bucket)   |
| Prefix            | Optional folder path (e.g., data/exports)          |
| Access Key ID     | The public identifier for your AWS IAM credentials |
| Secret Access Key | The private key paired with your Access Key ID     |