VK Cloud logo
Помощь
Обновлена 27 марта 2024 г. в 14:33

CORS

Сервис Cloud Storage позволяет управлять конфигурацией CORS бакета. Для загрузки конфигурации CORS необходимо сформировать XML-документ.

Перечень доступных методов для конфигураций CORS бакета:

  • Get Bucket CORS — получить список конфигураций CORS для бакета.
  • Set Bucket CORS — установить конфигурацию CORS.
  • Delete Bucket CORS — удалить конфигурацию CORS.

Общий вид XML конфигурации CORS

<CORSConfiguration>    <CORSRule>        <AllowedOrigin>URL</AllowedOrigin>        <AllowedMethod>HTTP_Method</AllowedMethod>        <AllowedHeader>Header_Name</AllowedHeader>        ...    </CORSRule>    ...</CORSConfiguration>

Get Bucket CORS

Операция возвращает информацию по конфигурации CORS, установленной для бакета.

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

Запрос:

GET /?cors HTTP/1.1Host: my-test-bucket1.hb.vkcs.cloudx-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855x-amz-date: 20200831T185319ZAuthorization: AWS4-HMAC-SHA256 Credential=II5JDQBAN3JYM4DNEB6C/20200831/ru-msk/s3/aws4_request,SignedHeaders=host;x-amz-content-sha256;x-amz-date,Signature=f7d7879992a9f3a06ddacd59e53ac318e99b2ed6230692b30099739e34469a91

Ответ:

HTTP/1.1 200 OKDate: Mon, 31 Aug 2020 18:53:20 GMTx-amz-request-id: tx00000000000000279651f-005963cd20-1268c-ru-mskaContent-Type: application/xmlContent-Length: 430Connection: close<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">  <CORSRule>    <AllowedMethod>PUT</AllowedMethod>    <AllowedMethod>DELETE</AllowedMethod>    <AllowedMethod>POST</AllowedMethod>    <AllowedOrigin>http://example.com</AllowedOrigin>    <AllowedHeader>\*</AllowedHeader>  </CORSRule>  <CORSRule>    <AllowedMethod>GET</AllowedMethod>    <AllowedOrigin>\*</AllowedOrigin>  </CORSRule></CORSConfiguration>

Set Bucket CORS

Операция PUT устанавливает конфигурацию CORS для бакета. Если конфигурация уже существует, то она переписывается.

Для того, чтобы воспользоваться данной операцией, необходимо обладать правами на запись WRITE_ACP.

Можно установить эту конфигурацию на бакете так, что он сможет обслуживать запросы Cross-origin. Например, можно предоставить доступ запросу из источника http://www.example.com к бакету my.example.bucket.com, используя функционал браузера XMLHttpRequest.

Для разрешения совместного использования ресурсов между разными источниками (CORS) на бакете необходимо добавить подресурс CORS на бакет. Подресурс CORS является XML-документом, в котором настраиваются правила, определяющие источники и методы HTTP, которые можно использовать в вашем бакете. Максимальный размер документа - 64 КБ. Например, у конфигурации CORS на бакете могут быть установлены два нижеследующих правила:

  • Первое правило CORSRule разрешает использовать Cross-origin-запросы PUT, POST и DELETE из источников https://www.example.com. Данное правило также разрешает использовать все заголовки в предполетном запросе OPTIONS с помощью заголовка Access-Control-Request-Headers. Следовательно, в качестве ответа на любой предполетный запрос OPTIONS, сервис возвращает любой запрошенный заголовок.
  • Второе правило разрешает использовать Cross-origin-запросы GET со всех источников. Подстановочный знак «*» указывает на возможность использования любого источника.

Запрос:

PUT /?cors HTTP/1.1Host: my-test-bucket1.hb.vkcs.cloudContent-Length: 374Content-Type: application/xmlx-amz-content-sha256: 745320970930725bd18820ec990f7334960f0a47358be189e77504cc094be77ex-amz-date: 20200831T185043ZAuthorization: AWS4-HMAC-SHA256 Credential=II5JDQBAN3JYM4DNEB6C/20200831/ru-msk/s3/aws4_request,SignedHeaders=content-md5;content-type;host;x-amz-content-sha256;x-amz-date,Signature=f52b2bfb6ec975c86cadd2e51a6ee9842c6151b737e46ce90a3cb3cc0d0dea97<CORSConfiguration> <CORSRule>   <AllowedOrigin>http://example.com</AllowedOrigin>   <AllowedMethod>PUT</AllowedMethod>   <AllowedMethod>POST</AllowedMethod>   <AllowedMethod>DELETE</AllowedMethod>   <AllowedHeader>\*</AllowedHeader> </CORSRule> <CORSRule>   <AllowedOrigin>\*</AllowedOrigin>   <AllowedMethod>GET</AllowedMethod> </CORSRule></CORSConfiguration>

Ответ:

HTTP/1.1 200 OKDate: Mon, 31 Aug 2020 18:50:44 GMTx-amz-request-id: tx0000000000000027946fc-005963cc84-1268c-ru-mskaContent-Type: application/xmlContent-Length: 0Connection: close

Delete Bucket CORS

Операция DELETE удаляет информацию по конфигурации CORS, установленной для бакета.

Для того, чтобы воспользоваться данной операцией, необходимо обладать правами на запись WRITE_ACP.

Запрос:

DELETE /static-images?cors HTTP/1.1Host: my-test-bucket1.hb.vkcs.cloudx-amz-content-sha256: e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855x-amz-date: 20200831T182537ZAuthorization: AWS4-HMAC-SHA256 Credential=II5JDQBAN3JYM4DNEB6C/20200831/ru-msk/s3/aws4_request,SignedHeaders=content-md5;content-type;host;x-amz-content-sha256;x-amz-date,Signature=e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

Ответ:

HTTP/1.1 204 No ContentDate: Mon, 31 Aug 2020 18:25:38 GMTx-amz-request-id: tx0000000000000002fae1f-0059690ca2-6441-ru-mskaConnection: close

Не нашли ответа?Напишите нам

© 2024 VK Cloud
Политика конфиденциальности