# Connecting to AWS S3 Storage

## AWS S3 Permissions

Connect [Publisher](https://github.com/DNAstack/dnastack-product-docs/blob/main/docs/publisher/data-sources/connectors/broken-reference/README.md) to [AWS S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) storage to access and share your data. The configuration process involves setting up connection details and choosing data update preferences.

## Prerequisites

Before starting, gather these required details:

* S3 bucket name
* Bucket region
* AWS Access Key ID
* AWS Secret Access Key

## Configuration Process

### Initial Setup

From the Publisher interface, select "Data Sources" in the navigation bar and click the "Connect Data Source" button. Choose "AWS S3 Object Store" from the available connectors.

### Connection Details

Enter your AWS S3 configuration:

* Storage Bucket name
* Access Key ID (or "Anonymous" for public access)
* Secret Access Key (or "Anonymous" for public access)
* Bucket Region (e.g., us-east-1)

{% hint style="info" %}
Note: For anonymous access to public buckets, use "Anonymous" for both the Access Key ID and Secret Access Key.
{% endhint %}

{% hint style="info" %}
For more information about creating AWS access keys, consult [AWS documentation](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey).
{% endhint %}

### Data Update Configuration

Configure how Publisher monitors your S3 bucket for changes:

* **S3 Event Notifications with SQS**:
  * Create a dedicated [SQS](https://docs.aws.amazon.com/AWSSimpleQueueService/latest/SQSDeveloperGuide/welcome.html) queue for S3 bucket notifications
  * If not already done, [grant Amazon S3 permissions](https://docs.aws.amazon.com/AmazonS3/latest/userguide/grant-destinations-permissions-to-s3.html#grant-sns-sqs-permission-for-s3) to publish messages to SQS.
  * Provide the SQS queue name
* **Scheduled Updates**:
  * Choose an update interval (30 seconds to daily)
  * Updates can be configured later if needed

## Finalizing Setup

Provide a descriptive name for your data source. After connection, you have the option to create and share a collection from this data source.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.omics.ai/products/publisher/data-sources/connectors/connecting-to-aws-s3-storage.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.