mc encrypt set
语法
mc encrypt set 加密命令用于设置或更新存储桶默认的
服务端加密(SSE)模式。MinIO 会使用指定的 SSE 模式
自动加密写入该存储桶的对象。
mc encrypt set 仅支持 SSE-KMS
和 SSE-S3。
以下命令为 myminio MinIO 部署上的 mydata 存储桶设置默认的
SSE-KMS 加密密钥:
mc encrypt set sse-kms "minio-encryption-key" myminio/mydata
命令语法如下:
mc [GLOBALFLAGS] encrypt set ENCRYPTION [KMSKEY] ALIAS
方括号
[]表示可选参数。同一行中的参数彼此相互依赖。
使用管道符
|分隔的参数彼此互斥。
请先将示例复制到文本编辑器中并按需修改,再在终端 / shell 中运行命令。
参数
- ENCRYPTION
指定作为默认 SSE 模式的服务端加密类型。 支持以下取值:
sse-kms- 使用KMSKEY中指定的密钥 对对象加密。MinIO 必须能够访问外部 KMS 上指定的密钥,才能成功加密 或解密受 SSE-KMS 保护的对象。sse-s3- 使用MINIO_KMS_KES_KEY_NAME指定的密钥 对对象加密。MinIO 必须能够访问外部 KMS 上指定的密钥,才能成功加密 或解密受 SSE-S3 保护的对象。
- KMSKEY
指定用于执行 SSE 对象加密的 KMS Master Key。该选项仅在
ENCRYPTION为sse-kms时生效。省略该选项可让 MinIO 使用
MINIO_KMS_KES_KEY_NAME.
- ALIAS
要设置默认 SSE 模式的存储桶完整路径。将 MinIO 部署的 alias 作为 TARGET 路径前缀。例如:
mc encrypt set ENCRYPTION [KMSKEY] play/mybucket
全局标志
此命令支持 全局标志 中的任意选项。
示例
启用自动服务端存储桶加密
以下命令假设:
MinIO 服务端配置支持 SSE-KMS
root KMS 上存在加密密钥
minio-encryption-key。
mc encrypt set sse-kms minio-encryption-key myminio/data
mc encrypt set ENCRYPTION KMSKEY TARGET
将
ENCRYPTION替换为sse-kms或sse-s3,具体取决于 所需的加密模式。将
KMSKEY替换为已配置 root KMS 中的加密密钥名称。 该参数对sse-s3无效。将
TARGET替换为要配置自动服务端存储桶加密的 MinIO 部署 alias。
行为
mc encrypt set 不会对 MinIO 服务端当前的加密状态作任何假设。
如果指定了服务端无法支持的默认加密设置,可能导致非预期行为。
设置或修改默认服务端加密设置时,不会 自动加密或解密存储桶中已有内容。
如果存储桶内容 必须 保持一致的加密状态,请使用 mc mv 命令并结合
--enc-kms、--enc-s3 或
--enc-c 指定迁移内容使用的加密类型。
这会在更改存储桶默认设置 之前,手动修改存储桶内容的加密设置或加密状态。