VK Cloud logo
Обновлена 25 апреля 2024 г. в 17:30

Начало работы

Получение эндпоинта

В личном кабинете уточните нужный эндпоинт в блоке Объектное хранилище S3.

Авторизация и аутентификация

Большинство запросов к Cloud Storage требуют аутентификации.

Данные аутентификации прописываются в заголовке Authorization запроса:

Authorization: <тип подписи>-<алгоритм подписи> Credential=<ключ-доступа>/<дата>/<регион>/s3/aws4_request,SignedHeaders=<заголовки>,Signature=<подпись>

Здесь:

  • <тип подписи>AWS4.

  • <алгоритм подписи>HMAC-SHA256.

  • <ключ-доступа>идентификатор ключа доступа к Cloud Storage.

  • <дата> — дата в формате ГГГГММДД.

  • <регион>регион аккаунта. Доступные значения:

    • ru-msk — региона Москва;
    • kz-ast — регион Казахстан.
  • <заголовки> — список заголовков, которые используются при вычислении подписи. Заголовки должны быть написаны только строчными буквами и располагаться в алфавитном порядке.

  • <подпись>вычисляемая подпись запроса.

Пример запроса с авторизацией:

PUT / HTTP/1.1Host: my-test-bucket1.hb.vkcs.cloudx-amz-acl: public-readx-amz-content-sha256: c6f1fc479f5f690c443b73a258aacc06ddad09eca0b001e9640ff2cd56fe5710x-amz-date: 20200831T173143ZAuthorization: AWS4-HMAC-SHA256 Credential=II5JDQBAN3JYM4DNEB6C/20200831/ru-msk/s3/aws4_request,SignedHeaders=host;x-amz-acl;x-amz-content-sha256;x-amz-date,Signature=6cab03bef74a80a0441ab7fd33c829a2cdb46bba07e82da518cdb78ac238fda5<CreateBucketConfiguration>  <LocationConstraint>ru-msk</LocationConstraint></CreateBucketConfiguration>