> For the complete documentation index, see [llms.txt](https://docs.mikopbx.com/mikopbx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mikopbx.com/mikopbx/manual/maintenance/storage/aws.md).

# Подключение S3 хранилища AWS

### Создание бакета

1. Перейдите в консоль AWS ([ссылка](https://console.aws.amazon.com/)). Перейдите в раздел "**Все сервисы**" -> "**Storage**" -> "**S3**".

<figure><img src="/files/pNFuCWn74SRK7ZqPY1GO" alt=""><figcaption><p>Раздел "S3" в AWS</p></figcaption></figure>

2. Нажмите "**Create bucket**".

<figure><img src="/files/NLm8CIMcPn5bstDaqRrc" alt=""><figcaption><p>Кнопка для создания бакета</p></figcaption></figure>

3. Укажите произвольное название для бакета (поле "**Bucket name**"). Все остальные параметры оставьте по умолчанию, нажмите "**Create bucket**".

<figure><img src="/files/27UC1lwpfjIhraPk7CQY" alt=""><figcaption><p>Параметры создаваемого бакета</p></figcaption></figure>

### Создание IAM пользователя и ключей доступа

1. Перейдите в раздел **"Все сервисы"** -> "**Security, Identity, & Compliance**" -> "**IAM**".

<figure><img src="/files/pokt8r57lb3Hj86Hkd5d" alt=""><figcaption><p>Раздел "IAM"</p></figcaption></figure>

2. Далее необходимо создать нового IAM пользователя. Для этого перейдите во вкладку "**Access Management**", далее "**Users**". Нажмите "**Create user**".

<figure><img src="/files/62tjRCKGmbTVoCuB361a" alt=""><figcaption><p>Создание нового IAM пользователя</p></figcaption></figure>

3. Укажите имя создаваемого IAM пользователя в поле "**User name**".

Нажмите "**Next**".

<figure><img src="/files/VVIivYPucL2BviMXpkyN" alt=""><figcaption><p>Вкладка "Specify user details"</p></figcaption></figure>

4. Выберите "**Attach policies directly**" в качестве "**Permissions options**". Пролистайте страницу.

<figure><img src="/files/Hci4irHlbZl6geg39xxg" alt=""><figcaption><p>Выбор "Permissions options"</p></figcaption></figure>

5. В разделе "**Permissions policies**" нажмите "**Create policy**".

<figure><img src="/files/ipz66weYoOswxON6hsDM" alt=""><figcaption><p>Кнопка "Create policy"</p></figcaption></figure>

6. В открывшейся вкладке, в окне "**Policy editor**", выберите "**JSON**" в качестве формата и вставьте следующий контекст в поле с параметрами:

```json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:PutObject",
        "s3:GetObject",
        "s3:DeleteObject",
        "s3:ListBucket"
      ],
      "Resource": [
        "arn:aws:s3:::имя-вашего-бакета",
        "arn:aws:s3:::имя-вашего-бакета/*"
      ]
    }
  ]
}
```

{% hint style="warning" %}
Замените "**имя-вашего-бакета**" на название созданого ранее бакета (в этой инструкции - "**aws-s3-mikopbxstorage**").
{% endhint %}

Нажмите "**Next**".

<figure><img src="/files/5p2QT9pG9NP71x6W0aQR" alt=""><figcaption><p>Создание новой политики. Шаг 1</p></figcaption></figure>

7. Далее укажите произвольное название для создаваемой политики.

Нажмите "**Next**".

<figure><img src="/files/0zBg6WDxU92AR3YsaK0n" alt=""><figcaption><p>Создание новой политики. Шаг 2</p></figcaption></figure>

8. Вернитесь на вкладку создания пользователя, обновите список политик и выберите ранее созданную policy (в этой инструкции - "**access-mikopbx**").

Нажмите "Next".

<figure><img src="/files/VVqVSiH6pZXiPoo3L4To" alt=""><figcaption><p>Выбор ранее созданной политики</p></figcaption></figure>

9. Подтвердите создание пользователя: нажмите "**Create user**".

<figure><img src="/files/AsA7gZd9K492hEKFgBhT" alt=""><figcaption><p>Подтверждение создания пользователя</p></figcaption></figure>

10. Откройте страницу созданного пользователя, нажав на его имя.

<figure><img src="/files/HQTMgHIqtwgaXCCF1iBB" alt=""><figcaption><p>Переход на страницу созданного пользователя</p></figcaption></figure>

11. Перейдите в раздел "**Security credentials**". Нажмите "Create access key".

<figure><img src="/files/isS8NCssh098u7nD3DWV" alt=""><figcaption><p>Создание access ключа</p></figcaption></figure>

12. Выберите "**Application running outside AWS**". Нажмите "**Next**".

<figure><img src="/files/FaYdjzghPQgn2MXLzbFa" alt=""><figcaption><p>Выбор параметров при создании ключа</p></figcaption></figure>

13. Введите описание ключа для того, чтобы идентифицировать его в будущем. Нажмите "**Create access key**".

<figure><img src="/files/pSRrLnN17XLAHGCDdgph" alt=""><figcaption><p>Описание ключа</p></figcaption></figure>

Будет отображены access key и secret access key ключи. Сохраните их, они понадобятся далее для настройки внутри MikoPBX.

{% hint style="warning" %}
Только сейчас можно просмотреть или загрузить секретный ключ доступа. Восстановить его позже будет невозможно.
{% endhint %}

<figure><img src="/files/Q4ZnT6PT1L3o43eahV15" alt=""><figcaption><p>Access key и Secret access key</p></figcaption></figure>

### Подключение к MikoPBX

1. Перейдите во вкладку "**Обслуживание**" -> "**Хранилище**".

<figure><img src="/files/PR7M92evvsOxjvktKCpM" alt=""><figcaption><p>Раздел "Облсуживание" -> "Хранилище"</p></figcaption></figure>

2. Перейдите на вкладку "**Облачное хранилище S3**" и заполните следующие поля:

* **Автоматическая загрузка записей в облачное хранилище** — включите переключатель.
* **URL точки доступа S3** — введите адрес доступа к S3 AWS, в зависимости от региона Вашего бакета ([ссылка ](https://docs.aws.amazon.com/general/latest/gr/s3.html)на таблицу со всеми url). В этой инструкции - `https://s3.ap-southeast-1.amazonaws.com`
* **Регион S3** — укажите **регион** **Вашего бакета**, в этой инструкции - `ap-southeast-1`
* **Имя бакета S3** — укажите имя бакета, созданного в AWS (например, `aws-s3-mikopbxstorage` в этой инструкции)
* **Ключ доступа** и **Секретный ключ** — вставьте значения, полученные при создании access ключа сервисного аккаунта.

Настройте ползунок **«Локальное хранение (режим S3)»** — выберите, как долго записи будут храниться локально до удаления после выгрузки в облако.

{% hint style="info" %}
Более короткое локальное хранение быстрее освобождает дисковое пространство.
{% endhint %}

Нажмите **«Сохранить»**.

<figure><img src="/files/1Ig5HgGcvooTejuborX0" alt=""><figcaption><p>Параметры подключения облачного хранилища S3 в MikoPBX</p></figcaption></figure>

После сохранения настроек нажмите "Проверить соединение". При успешном подключении появится сообщение «**Подключено к S3**» и начнется синхронизация записей телефонных разговоров.

<figure><img src="/files/SXeyTl5nC2NKBABFonHf" alt=""><figcaption><p>Успешное подключение</p></figcaption></figure>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.mikopbx.com/mikopbx/manual/maintenance/storage/aws.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.