Server-Side Encryption Per-Deployment Key (SSE-S3)
MinIO 服务端加密（SSE）在写入操作过程中保护对象，使客户端能够利用服务器处理能力在存储层保护对象（静态加密）。SSE 还为安全锁定和擦除方面的法规与合规要求提供关键功能。
MinIO SSE 使用MinIO Key Encryption Service (KES)以及一个外部密钥管理服务（KMS），用于大规模执行安全加密操作。MinIO 还支持客户端管理的密钥管理，其中应用程序全权负责创建和管理用于 MinIO SSE 的加密密钥。
MinIO SSE-S3 使用由密钥管理系统（KMS）管理的外部密钥（EK）对对象进行加/解密。您必须指定EK使用MINIO_KMS_KES_KEY_NAME在启动 MinIO 服务器时设置环境变量。MinIO 使用相同的 EK 用于全部SSE-S3 加密操作。
您可以使用以下方式启用存储桶默认的 SSE-S3 加密：mc encrypt set命令：
mc encrypt set sse-s3 play/mybucket
替换
play/mybucket随着alias以及您想要启用自动 SSE-KMS 加密的存储桶。
MinIO SSE-S3 在功能上与 AWS S3 兼容使用 Amazon S3 托管密钥的服务器端加密同时扩展支持以包含以下 KMS 提供商：
快速入门
重要
启用SSE在 MinIO 部署中自动使用默认加密密钥对该部署的后端数据进行加密。
MinIO需要访问 KES 和外部 KMS 以解密后端并正常启动。
KMS必须维护并提供对...的访问权限MINIO_KMS_KES_KEY_NAME您之后无法禁用 KES 或"撤销"该操作SSE稍后进行配置。
以下过程使用playMinIOKES沙盒用于
支持SSE在评估和早期开发环境中使用 SSE-S3。
对于扩展开发或生产环境，请使用以下受支持的外部密钥管理服务（KMS）之一：
重要
MinIO KESPlaysandbox 是公开的，并授予所有创建的 External Keys (EK) 根访问权限。
任何EK存储在Play沙盒可能随时被访问或销毁，导致受保护的数据易受攻击或永久无法读取。
从不使用
Play沙盒，用于保护您无法承受丢失或泄露的数据。从不生成EK使用暴露组织内部私有、机密或内部命名约定的名称。
从不使用
Play生产环境的沙箱。
此过程需要以下组件：
安装MinIO Key Encryption Service (KES)在一台可以访问互联网的机器上。 请参阅 KES入门指南有关下载、安装和配置 KES 的指南说明。
1) 为 SSE-S3 加密创建加密密钥
使用咳嗽用于创建新外部密钥（EK）的命令行工具，该密钥用于SSE-S3加密。
以下命令检索根目录身份对于连接到 KES 的 KES 服务器play沙盒：
curl -sSL --tlsv1.2 \
-O 'https://raw.githubusercontent.com/minio/kes/master/root.key' \
-O 'https://raw.githubusercontent.com/minio/kes/master/root.cert'
在终端或shell中设置以下环境变量：
export KES_CLIENT_KEY=root.key
export KES_CLIENT_CERT=root.cert
|
用于身份在 KES 服务器上。
该身份必须至少授予对以下内容的访问权限： |
|---|---|
|
相应的证书身份在 KES 服务器上。
此步骤使用 |
以下命令创建一个新的EK通过KES CLI:
kes key create my-minio-sse-s3-key
本教程使用示例my-minio-sse-s3-key为便于引用，请指定一个唯一的键名，以避免与现有键发生冲突。
2) 配置 MinIO 以启用 SSE-S3 对象加密
在部署中的每个 MinIO 服务器主机的 shell 或终端中指定以下环境变量：
export MINIO_KMS_KES_ENDPOINT=https://play.min.io:7373
export MINIO_KMS_KES_API_KEY=<API-key-identity-string-from-KES> # Replace with the key string for your credentials
export MINIO_KMS_KES_KEY_NAME=my-minio-sse-s3-key
Note
API密钥是与KES服务器进行身份验证的首选方式，因为它为KES服务器提供了简化且安全的身份验证流程。
或者，指定
MINIO_KMS_KES_KEY_FILE和MINIO_KMS_KES_CERT_FILE而不是MINIO_KMS_KES_API_KEY.API keys与基于证书的身份验证是互斥的。 指定要么API密钥变量or密钥文件和证书文件变量。
本网站的文档使用 API 密钥。
MinIO 的端点 |
|
与私钥文件对应的身份在KES服务上。该身份必须授予创建、生成和解密密钥的权限。请指定与 |
|
与私钥对应的公钥证书文件身份在KES服务上。该身份必须授予创建、生成和解密密钥的权限。请指定与 |
|
用于执行 SSE 加密操作的外部密钥（EK）名称。KES 将获取该EK从配置的密钥管理系统 (KMS) 中获取。请指定上一步中创建的密钥名称。 |
3) 重启 MinIO 部署以启用 SSE-S3
您必须重启 MinIO 部署以使配置更改生效。
使用mc admin service restart重启部署的命令。
mc admin service restart ALIAS
替换ALIAS随着别名部署的重启。
4) 配置存储桶自动加密
可选
如果您打算仅使用客户端驱动的 SSE-S3，可以跳过此步骤。
使用mc encrypt set为特定存储桶中写入的所有对象启用自动 SSE-S3 保护的命令。
mc encrypt set sse-s3 ALIAS/BUCKET
安全擦除与锁定
SSE-S3 使用一种EK在服务器启动时指定
使用MINIO_KMS_KES_KEY_NAME环境变量。因此 MinIO需要访问该EK用于解密该对象。
禁用EK暂时锁定部署中SSE-S3加密的对象，使其无法读取。您稍后可以启用EK恢复正常读取操作。
删除EK呈现部署中所有SSE-S3加密对象永久地不可读。如果 KMS 没有或不支持备份EK这个过程是不可逆的.
The scope of theEK取决于：
哪些存储桶指定了自动 SSE-S3 加密，和
哪些写入操作请求了 SSE-S3 加密。
加密过程
Note
以下部分描述了 MinIO 的内部逻辑和功能。 这些信息仅供学习参考，并非配置或实现任何 MinIO 功能所必需。
SSE-S3 使用由配置的密钥管理系统（KMS）管理的外部密钥（EK）来执行加密操作并保护对象。 下表描述了加密过程的每个阶段：
阶段 |
描述 |
|---|---|
SSE-Enabled Write Operation |
MinIO 接收到一个要求 SSE-S3 加密的写入操作。
MinIO 使用指定的密钥名称来 |
生成数据加密密钥（DEK） |
MinIO 使用EK具体来说，MinIO Key Encryption Service (KES)向 KMS 请求一个新的加密密钥EK作为"root"键。 KES 同时返回明文和 an EK- DEK 的加密表示形式。 MinIO 将加密表示形式存储为对象元数据的一部分。 |
生成密钥加密密钥 (KEK) |
MinIO使用确定性算法生成256位唯一的密钥加密密钥(KEK)。 密钥派生算法采用伪随机函数，该函数接收明文DEK一个随机生成的初始化向量，以及包含存储桶和对象名称等值的上下文。 MinIO 在每次加密或解密操作时生成 KEK，从不将 KEK 存储到驱动器。 |
生成对象加密密钥（OEK） |
MinIO 生成一个随机的 256 位唯一对象加密密钥（OEK），并使用该密钥对对象进行加密。 MinIO 永远不会在驱动器上存储 OEK 的明文形式。 在加密操作期间，明文 OEK 仅存在于 RAM 中。 |
加密对象 |
MinIO 使用OEK加密该对象之前到将对象存储到驱动器。然后 MinIO 对OEK随着KEK. MinIO存储加密后的数据表示形式OEK和DEK作为元数据的一部分。 |
