文档基于2025-10-10日社区最终版构建     
切换到英文版    进入演示系统    进入交流社区

MinIO Documentation

密钥加密服务设置

MinIO Server 包含三组环境变量,用于管理 MinIO Server 与密钥加密服务(KES)、密钥管理服务(KMS)或静态密钥文件的交互方式。 您只能定义这三组环境变量中的一组。 如果定义了多种类型的环境变量集,MinIO 将返回错误。

Note

这些设置没有用于配置的设置选项mc admin config set.

在启动或重启 MinIO 进程之前,请在主机系统中定义以下任意一组环境变量。 有关如何定义环境变量的具体操作,请参阅您操作系统的文档。

重要

每个配置设置控制着 MinIO 的基本行为和功能。 MinIO强烈建议在应用到生产环境之前,先在较低环境(如开发环境或测试环境)中测试配置变更。

密钥加密服务

定义以下变量以使用密钥加密服务(KES)连接到支持的第三方密钥管理服务提供商.

MINIO_KMS_KES_ENDPOINT

MinIO Key Encryption Service (KES) 进程用于支持 SSE-S3 和 MinIO 后端加密操作的端点。 多个 KES 端点请使用,.

MINIO_KMS_KES_KEY_NAME

外部密钥在 KES(密钥加密服务)服务器上配置的密钥管理系统(KMS)中的名称,用于执行加密/解密操作。 MinIO 使用此密钥用于以下用途:

  • 加密后端数据 (IAM服务器配置)。

  • 使用服务器端加密的默认加密密钥SSE-KMS.

  • 使用服务器端加密的加密密钥SSE-S3.

重要

启用SSE在 MinIO 部署中自动使用默认加密密钥对该部署的后端数据进行加密。

MinIO需要访问 KES 和外部 KMS 以解密后端并正常启动。 KMS必须维护并提供对...的访问权限MINIO_KMS_KES_KEY_NAME您之后无法禁用 KES 或"撤销"该操作SSE稍后进行配置。

MINIO_KMS_KES_API_KEY

使用从加密服务获取的KES API密钥进行身份验证的首选方法kes identity new命令。

此环境变量与MINIO_KMS_KES_KEY_FILEMINIO_KMS_KES_CERT_FILE环境变量。

MINIO_KMS_KES_KEY_FILE

与私钥相关联的MINIO_KMS_KES_CERT_FILE用于验证 KES 服务器身份的 x.509 证书。 KES 服务器要求客户端提供其证书以执行双向 TLS(mTLS)验证。

查看KES wiki有关 KES 访问控制的更完整文档。

您还必须设置MINIO_KMS_KES_CERT_FILE这个变量与以下内容互斥:MINIO_KMS_KES_API_KEY.

MINIO_KMS_KES_CERT_FILE

要呈现给 KES 服务器的 x.509 证书。 KES 服务器要求客户端提供其证书以执行双向 TLS(mTLS)。

KES服务器计算一个身份来自证书并将其与其配置的策略进行比较。 KES服务器授予minio服务器仅可访问策略明确授予的操作。

查看KES wiki有关 KES 访问控制的更完整文档。

您还必须设置MINIO_KMS_KES_KEY_FILE这个变量与以下内容互斥:MINIO_KMS_KES_API_KEY.

MINIO_KMS_KES_CAPATH
可选

允许验证自签名或第三方证书的KES服务器证书CA指定位置的路径到CA您的 KES 部署的证书。

如果您使用公共证书颁发机构,则不需要此变量。

MINIO_KMS_KES_KEY_PASSWORD
可选

用于加密和解密 TLS 私钥的密码(如果使用)。

MinIO Key Management Server (KMS)

定义以下变量以供使用MinIO KMS管理密钥。

MINIO_KMS_SERVER

MinIO 密钥管理服务(KMS)进程用于支持 SSE-S3 和 MinIO 后端加密操作的端点。 多个 KMS 端点请用,.

MINIO_KMS_ENCLAVE

MinIO KMS Enclave,其中存在密钥和身份信息。

MINIO_KMS_SSE_KEY

当调用未指定密钥身份时,用于SSE-S3加密的默认密钥。

MINIO_KMS_API_KEY

用于验证 MinIO KMS 服务的凭据。

静态密钥文件

警告

这些设置支持在不依赖外部KMS的情况下对对象进行服务器端加密的早期开发和评估。 请勿在任何长期开发、QA或生产环境中使用这些设置。 参见使用 KES 进行服务端对象加密有关使用 MinIO 密钥加密服务(KES)和外部 KMS 部署 SSE 的指南。

提供一个静态的KMS密钥或密钥文件用于加密。

MINIO_KMS_SECRET_KEY

静态KMS密钥的base64形式<key-name>:<base64-32byte-key>实现了KMS API的一个子集。

MINIO_KMS_SECRET_KEY_FILE

读取静态KMS密钥的文件路径。