nav-img
Evolution

Настроить публичный доступ к бакету в Object Storage

По умолчанию бакеты в Object Storage создаются с приватным доступом. Это значит, что загружать объекты в бакет, изменять их версии, а также настраивать к ним доступ может только авторизованный пользователь с персональным API-ключом или ключом сервисного аккаунта.

Чтобы пользователи и приложения имели доступ к объектам в бакете без авторизации, настройте публичный доступ:

Управлять публичным доступом можно через ACL и Bucket Policy.

Внимание

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

Мы как поставщик инфраструктуры обеспечиваем надежность хранения данных в нашем облаке, а вы как владелец самих данных обеспечиваете контроль доступа к ним и отвечаете за их сохранность (подробнее — в пп. 1.1.6. , пп. 1.1.9, п. 1.2. Приложения 3 к Договору).

Напишите в техническую поддержку — и мы расскажем, с чего начать, чтобы правильно организовать работу с Object Storage.

Открыть доступ через ACL

ACL позволяет выдать пользователям разрешения на операции с объектами в бакете: чтение списка объектов, скачивание, запись и перезапись.

Все новые бакеты или объекты в хранилище создаются с отключенным ACL и параметром владения ресурсом OwnershipControls = BucketOwnerEnforced. Подробнее в документации AWS.


  1. Установите и настройте AWS CLI.

  2. Измените значение на OwnershipControls=ObjectWriter для бакета:

    aws s3api put-bucket-ownership-controls \
    --endpoint-url=https://s3.cloud.ru \
    --bucket <bucket_name> \
    --ownership-controls="Rules=[{ObjectOwnership=ObjectWriter}]"

    где:

    • <endpoint> — URL, адрес доступа к бакету.

    • put-bucket-ownership-controls — команда, устанавливает владение объектами бакета.

    • <bucket_name> — название бакета.

    • --ownership-controls — параметр, устанавливает правила для бакета.

  3. Назначьте права на чтение и запись через предопределенное разрешение — Canned ACL.

    aws --endpoint-url=https://s3.cloud.ru s3api put-bucket-acl --bucket <bucket_name> --acl public-read-write

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

Закрыть публичный доступ через ACL

Чтобы закрыть доступ к ресурсам, отключите ACL (OwnershipControls = BucketOwnerEnforced).


Выполните команду:

aws s3api put-bucket-ownership-controls \
--endpoint-url=https://s3.cloud.ru \
--bucket <bucket_name> \
--ownership-controls="Rules=[{ObjectOwnership=BucketOwnerEnforced}]"
Подсказка

Удалить созданный ACL нельзя. Чтобы удалить разрешения, передайте пустой ACL.

Открыть доступ через Bucket Policy


  1. Авторизуйтесь в личном кабинете.

  2. На верхней панели слева нажмите Кнопка с изображением девяти точек и выберите Хранение данных → Object Storage.

  3. В списке бакетов выберите нужный.

  4. Слева выберите Настройка Bucket Policy.

  5. Активируйте опцию Публичный доступ к бакету.

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

Закрыть публичный доступ через BucketPolicy


  1. Авторизуйтесь в личном кабинете.

  2. На верхней панели слева нажмите Кнопка с изображением девяти точек и выберите Хранение данных → Object Storage.

  3. В списке бакетов выберите нужный.

  4. Слева выберите Настройка Bucket Policy.

  5. Деактивируйте опцию Публичный доступ к бакету.

Загрузить объект в публичный бакет

  1. Авторизуйтесь в личном кабинете.

  2. На верхней панели слева нажмите Кнопка с изображением девяти точек и выберите Хранение данных → Object Storage.

  3. В списке бакетов выберите нужный.

  4. Слева выберите О бакете.

  5. Проверьте, что для бакета указаны Глобальное название или Доменное имя.

    Если ни одно из полей не заполнено, измените настройки бакета.

  6. Загрузите объект в бакет с адресацией через:

    • глобальное название — https://global.s3.cloud.ru/<global_bucket_name>/<object_key>.

    • доменное имя — https://<domain_bucket_name>.s3.cloud.ru/<object_key>.

Пример загрузки файла my_image.png в бакет по глобальному названию global_my_bucket:

curl --location --request PUT 'https://global.s3.cloud.ru/global_my_bucket/images' \
--header 'Content-Type: image/png' \
--data '@path/to/my_image.png'

Результат:

HTTP/2 100 Continue
HTTP/2 200 OK
x-amz-request-id: 318BC8BC********
x-amz-copy-source-version-id: 3/L4kqtJlcpX********
x-amz-version-id: QUpfdndhfd8438MNFDN93jdnJFk********
Date: Wed, 25 Oct 2023 22:32:00 GMT
ETag: "1b2cf535f27731c974343645********"
Content-Length: 0
Connection: close
Server: s3.cloud.ru