Учетные данные Yandex Object Storage

Настройка учетных данных для работы с Yandex Object Storage

Введение

Учетные данные Yandex Object Storage необходимы для работы функций, которые работают с файлами в облачном хранилище. Для создания учетных данных вам понадобятся ключи доступа и информация о bucket из Yandex Cloud.

Учетные данные создаются в разделе Учетные данные.

Начало работы с Yandex Object Storage

Если у вас еще нет аккаунта Yandex Cloud и bucket:

  1. Зарегистрируйтесь в Yandex Cloud
  2. Создайте облако и каталог
  3. Создайте сервисный аккаунт с ролью storage.editor
  4. Создайте статический ключ доступа для сервисного аккаунта
  5. Создайте bucket в Object Storage

Подробная документация по работе с Yandex Object Storage доступна в официальной документации Yandex Cloud.

Access Key ID

Access Key ID — это публичный идентификатор ключа доступа. Он используется вместе с Secret Access Key для аутентификации в Yandex Object Storage.

Чтобы получить Access Key ID:

  1. Войдите в консоль Yandex Cloud
  2. Перейдите в раздел "Сервисные аккаунты"
  3. Выберите нужный сервисный аккаунт (или создайте новый)
  4. Перейдите на вкладку "Ключи"
  5. Создайте статический ключ доступа
  6. Скопируйте Access Key ID

Access Key ID выглядит примерно так: YCAJxxxxxxxxxxxxxxxxxxxxx

Access Key ID не является секретной информацией, но его следует хранить в безопасности вместе с Secret Access Key.

Secret Access Key

Secret Access Key — это секретный ключ, который используется вместе с Access Key ID для аутентификации. Это критически важная информация, которую необходимо хранить в секрете.

Secret Access Key предоставляется только один раз при создании статического ключа доступа. Если вы потеряли ключ, необходимо создать новый.

Важно:

  • Никогда не делитесь Secret Access Key публично
  • Не коммитьте ключ в репозитории
  • Храните ключ в безопасном месте
  • Если ключ скомпрометирован, немедленно создайте новый и обновите учетные данные
Secret Access Key предоставляется только при создании ключа. Сохраните его сразу, так как позже получить его будет невозможно.

Bucket

Bucket — это контейнер для хранения объектов (файлов) в Yandex Object Storage. Каждый bucket имеет уникальное имя в рамках региона.

Чтобы создать bucket:

  1. Войдите в консоль Yandex Cloud
  2. Перейдите в раздел "Object Storage"
  3. Нажмите "Создать bucket"
  4. Укажите имя bucket (должно быть уникальным в регионе)
  5. Выберите регион
  6. Настройте параметры доступа
  7. Создайте bucket

Имя bucket используется в учетных данных для указания, в каком bucket будут храниться файлы.

Регион

Регион определяет географическое расположение bucket. Выберите регион, который ближе всего к вашим пользователям или соответствует требованиям к хранению данных.

Доступные регионы Yandex Object Storage:

  • ru-central1 — Центральная Россия (по умолчанию)
  • Другие регионы в зависимости от вашего тарифа

По умолчанию используется регион ru-central1. Если ваш bucket находится в другом регионе, укажите соответствующий регион при настройке учетных данных.

Настройка в системе

Чтобы создать учетные данные Yandex Object Storage в системе:

  1. Откройте раздел Учетные данные
  2. Нажмите "Создать учетные данные"
  3. Выберите тип "Yandex Object Storage"
  4. Заполните поля:
    • Название — удобное имя для идентификации (например, "Хранилище документов")
    • Access Key ID — публичный идентификатор ключа доступа
    • Secret Access Key — секретный ключ доступа
    • Bucket — имя bucket в Object Storage
    • Регион — регион bucket (по умолчанию: ru-central1)
  5. Сохраните учетные данные

После сохранения учетные данные будут доступны для использования в функциях ботов.

Решение проблем

Ошибка аутентификации

Если возникает ошибка аутентификации:

  • Проверьте правильность Access Key ID и Secret Access Key
  • Убедитесь, что ключи не истекли и не были отозваны
  • Проверьте, что сервисный аккаунт имеет необходимые права доступа
  • Убедитесь, что ключи скопированы полностью, без лишних пробелов

Bucket не найден

Если bucket не найден:

  • Проверьте правильность имени bucket
  • Убедитесь, что bucket существует в указанном регионе
  • Проверьте, что сервисный аккаунт имеет доступ к bucket
  • Убедитесь, что указан правильный регион

Ошибка доступа

Если возникает ошибка доступа:

  • Проверьте права доступа сервисного аккаунта (должна быть роль storage.editor или выше)
  • Убедитесь, что bucket доступен для сервисного аккаунта
  • Проверьте настройки доступа bucket в консоли Yandex Cloud

Ошибка при сохранении

Если не удается сохранить учетные данные:

  • Проверьте, что все обязательные поля заполнены
  • Убедитесь, что Access Key ID и Secret Access Key введены правильно
  • Проверьте, что имя bucket указано корректно
  • Убедитесь, что регион соответствует региону bucket

Связанные темы

Мы используем cookies для улучшения работы сайта. Продолжая пользоваться сайтом, вы соглашаетесь с политикой использования cookies.