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

# S3 Access Keys

> Authorize the S3 connector using AWS Access Keys.

## AWS Access Keys Authorization

<Steps>
  <Step title="Open AWS Console">
    Log into your AWS Management Console.
  </Step>

  <Step title="Open IAM">
    Navigate to the IAM (Identity and Access Management) dashboard.
  </Step>

  <Step title="Create user">
    In the left sidebar, click on "Users" and then "Create user".

    <img className="rounded-image" src="https://mintcdn.com/danswer/aj13v1mzLf028SWE/assets/admins/connectors/blob/s3/iam.png?fit=max&auto=format&n=aj13v1mzLf028SWE&q=85&s=45b4dceffc75a3a050e118ace6e09982" alt="AWS IAM dashboard with Users section for creating a user" width="3450" height="754" data-path="assets/admins/connectors/blob/s3/iam.png" />
  </Step>

  <Step title="Set user details">
    Set a name for the new user (e.g., "OnyxS3Connector") and click "Next".
  </Step>

  <Step title="Attach policy">
    Click "Attach policies directly" and search for "AmazonS3ReadOnlyAccess" or a similarly permissive policy.
    Select this policy and click "Next".
  </Step>

  <Step title="Create user">
    Add any tags if needed, then click "Create user".
  </Step>

  <Step title="Create access key">
    On the users page, click on the user you just created. In the summary section,
    click "Create access key" and choose "Third-party service" as the use case. Confirm the disclaimer and continue.
  </Step>

  <Step title="Copy keys">
    Optionally set a description tag and then press "create access key".
    Copy the Access Key ID and Secret Access Key immediately; you won't be able to view the secret again.

    <img className="rounded-image" src="https://mintcdn.com/danswer/aj13v1mzLf028SWE/assets/admins/connectors/blob/s3/accesskeyspage.png?fit=max&auto=format&n=aj13v1mzLf028SWE&q=85&s=5b6f5aec65a6d76959c550ba511b4162" alt="AWS security credentials page" width="3338" height="1644" data-path="assets/admins/connectors/blob/s3/accesskeyspage.png" />
  </Step>
</Steps>

### Credential Entry in Onyx

When configuring the S3 connector in Onyx, you'll enter your credentials as follows:

* **AWS Access Key ID**: Paste the Access Key ID you copied from AWS
* **AWS Secret Access Key**: Paste the Secret Access Key you copied from AWS

<img className="rounded-image" src="https://mintcdn.com/danswer/aj13v1mzLf028SWE/assets/admins/connectors/blob/s3/onyx-access-key.png?fit=max&auto=format&n=aj13v1mzLf028SWE&q=85&s=11bb2a7782d5cb0e4a4797485eac2b18" alt="Onyx S3 connector configuration with Access Key ID and Secret fields" width="3450" height="1908" data-path="assets/admins/connectors/blob/s3/onyx-access-key.png" />

Once you have your AWS Access Keys, proceed to the [indexing steps in the overview](./overview#indexing)
to configure your S3 connector.