Encryption
Методы для работы с шифрованием объектов:
- GetBucketEncryption — получить конфигурацию шифрования, установленную на бакет.
- PutBucketEncryption — установить шифрование объектов на бакет.
- DeleteBucketEncryption — удалить шифрование объектов.
Метод GetBucketEncryption возвращает конфигурацию шифрования, установленную на бакет.
Пример запроса:
GET /?encryption HTTP/1.1Host: my-test-bucket1.hb.bizmrg.comx-amz-expected-bucket-owner: ExpectedBucketOwner
Пример успешного ответа:
HTTP/1.1 200<?xml version="1.0" encoding="UTF-8"?><ServerSideEncryptionConfiguration><Rule><ApplyServerSideEncryptionByDefault><KMSMasterKeyID>string</KMSMasterKeyID><SSEAlgorithm>string</SSEAlgorithm></ApplyServerSideEncryptionByDefault><BucketKeyEnabled>boolean</BucketKeyEnabled></Rule>...</ServerSideEncryptionConfiguration>
Код ошибки
HTTP: 400. Ошибка ServerSideEncryptionConfigurationNotFoundError — отсутствие конфигурации по умолчанию.
Метод PutBucketEncryption устанавливает шифрование для бакета по умолчанию. Если шифрование не устанавливало, новые объекты при загрузке в бакет не шифруются. Генерация и расшифровка ключей производится KMS. Используемый алгоритм шифрования AES256.
Пример запроса:
PUT /?encryption HTTP/1.1Host: my-test-bucket1.hb.bizmrg.comContent-MD5: ContentMD5x-amz-sdk-checksum-algorithm: ChecksumAlgorithmx-amz-expected-bucket-owner: ExpectedBucketOwner<?xml version="1.0" encoding="UTF-8"?><ServerSideEncryptionConfiguration xmlns="<http://hb.bizmrg.com/doc/2006-03-01/>"><Rule><ApplyServerSideEncryptionByDefault><SSEAlgorithm>AES256</SSEAlgorithm></ApplyServerSideEncryptionByDefault></Rule></ServerSideEncryptionConfiguration>
Path параметры
Параметр | Обязательный | Тип данных | Значение | Описание |
|---|---|---|---|---|
Bucket | Да | bucket-name |
|
|
SSEAlgorithm | Да | enum | AES256 | Алгоритм шифрования на стороне сервера, используемый при хранении. При добавлении заголовка объект, сохраненный в бакете, должен быть зашифрован на стороне сервера |
Код ответа
HTTP: 200 OK.
Метод DeleteBucketEncryption удаляет установленную на бакет конфигурацию шифрования объектов, если она задана.
Пример запроса:
DELETE /?encryption HTTP/1.1Host: my-test-bucket1.hb.bizmrg.comx-amz-expected-bucket-owner: ExpectedBucketOwner
Код ответа
HTTP: 204 No Content — сервер успешно обработал запрос.