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

# S3: обзор

> Обзор коннектора S3

## Как это работает

Коннектор S3 получает все документы из указанной корзины Amazon S3. Он поддерживает различные форматы файлов,
включая PDF, DOC, DOCX, TXT и другие.

Документы обновляются раз в **1** день.

## Настройка

### Авторизация

Мы поддерживаем три метода авторизации — выберите подходящий для вашей среды:

* [Ключи доступа AWS](./access-keys) — использует традиционные учётные данные с ключами доступа
* [Авторизация на основе роли IAM](./iam-role) — использует роли AWS IAM для безопасного доступа
* [Assume Role](./assume-role) — автоматически использует роль, прикреплённую к инстансу EC2, для доступа к S3

### Индексирование

После настройки метода авторизации выполните следующие шаги, чтобы проиндексировать корзину S3:

**1. Откройте коннектор S3**

Откройте панель администратора Yahont и выберите коннектор **S3**.

**2. Настройте авторизацию**

На **шаге 1** настройте авторизацию:

* Если у вас есть учётные данные, выберите их из списка
* Если учётных данных нет, нажмите **Create New**, чтобы добавить новую авторизацию:
* **Access Keys**: введите AWS Access Key ID и Secret Access Key
* **IAM Role**: откройте вкладку IAM Role и введите Role ARN
* **Assume Role**: откройте вкладку Assume Role (учётные данные не требуются)

**3. Сохраните конфигурацию**

Нажмите **Create**, чтобы сохранить конфигурацию.

**4. Продолжите с выбранными учётными данными**

Убедитесь, что выбраны нужные учётные данные, и нажмите **Continue**

**5. Укажите сведения о корзине**

На **шаге 2** укажите сведения о вашей корзине S3:

* **Connector Name**: введите название коннектора (например, «MyS3Connector»)
* **Bucket Name**: укажите имя корзины S3, которую хотите индексировать
* **Prefix (Optional)**: укажите префикс, чтобы ограничить индексацию определённой папкой или путём
* **Access Type**: выберите, будут ли документы **Public** или **Private**

**6. Создайте коннектор**

Нажмите **Create Connector**, чтобы начать индексацию.

Коннектор начнёт индексировать вашу корзину S3, а позже можно добавить другие корзины или изменить настройки.

![Страница сведений о коннекторе S3 в Yahont](https://mintcdn.com/yahont-ai/GgKRVXXDNIirDkuK/assets/admins/connectors/blob/s3/connector.png?fit=max\&auto=format\&n=GgKRVXXDNIirDkuK\&q=85\&s=04153466307dd991e4a9297f497a5572)

## Как устроено хранилище S3

Amazon S3 организует данные в корзины (buckets). В каждой корзине может быть неограниченное число объектов (файлов).
Корзину можно представить как корневой каталог, а объекты — как файлы в этом каталоге.

Подробнее о структуре S3 читайте в [документации Amazon
S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.