MinIO 对象锁定
概述
MinIO 对象锁定(“对象保留”)对已版本化对象强制执行一次写入多次读取 (WORM) 不变性,以防止删除。MinIO 支持基于时间的对象保留和无限期法律保留。
MinIO 对象锁定提供关键数据保留合规性,并满足 SEC17a-4(f)、FINRA 4511(C) 和 CFTC 1.31(c)-(d) 的要求,根据 Cohasset Associates。
MinIO 对象锁定是AWS S3 的功能和 API 兼容。此页面汇总了 MinIO 实施的对象锁定/保留概念。有关更多资源,请参阅有关 S3 对象锁定工作原理 的 AWS S3 文档。
您只能在存储桶创建期间启用对象锁定,根据 S3 行为。您不能在没有启用锁定的存储桶上启用对象锁定。然后,您可以随时配置对象保留规则。对象锁定需要版本控制,并且会隐式启用该功能。
与版本控制的交互
在 WORM 锁定下保存的对象在锁定过期或显式解除之前是不可变的。锁定按对象版本进行,每个版本都是独立不可变的。
如果应用程序对已锁定对象执行非版本化删除操作,该操作将生成一个删除标记。尝试显式删除任何 WORM 锁定对象都会失败并出现错误。删除标记不符合 WORM 锁定下的保护条件。有关更多信息,请参见 S3 文档中的管理删除标记和对象生命周期。
例如,考虑以下带有GOVERNANCE 模式锁定的存储桶,该模式默认启用。
$ mc ls --versions play/locking-guide
[DATETIME] 29B 62429eb1-9cb7-4dc5-b507-9cc23d0cc691 v3 PUT data.csv
[DATETIME] 32B 78b3105a-02a1-4763-8054-e66add087710 v2 PUT data.csv
[DATETIME] 23B c6b581ca-2883-41e2-9905-0a1867b535b8 v1 PUT data.csv
尝试对data.csv
的特定版本执行删除操作将由于对象锁定设置而失败。
$ mc rm --version-id 62429eb1-9cb7-4dc5-b507-9cc23d0cc691 play/data.csv
Removing `play/locking-guide/data.csv` (versionId=62429eb1-9cb7-4dc5-b507-9cc23d0cc691).
mc: <ERROR> Failed to remove `play/locking-guide/data.csv`.
Object, 'data.csv (Version ID=62429eb1-9cb7-4dc5-b507-9cc23d0cc691)' is
WORM protected and cannot be overwritten
尝试对data.csv
执行非版本化删除操作将成功,并为该对象创建一个新的DeleteMarker
。
$ mc rm play/locking-guide/data.csv
[DATETIME] 0B acce329f-ad32-46d9-8649-5fe8bf4ec6e0 v4 DEL data.csv
[DATETIME] 29B 62429eb1-9cb7-4dc5-b507-9cc23d0cc691 v3 PUT data.csv
[DATETIME] 32B 78b3105a-02a1-4763-8054-e66add087710 v2 PUT data.csv
[DATETIME] 23B c6b581ca-2883-41e2-9905-0a1867b535b8 v1 PUT data.csv
与生命周期管理的交互
MinIO 对象过期会尊重任何对受过期规则涵盖的对象生效的对象锁定和保留设置。
对于仅对当前对象版本进行操作的过期规则,MinIO 将为已锁定对象创建一个删除标记。
对于对非当前对象版本进行操作的过期规则,MinIO 只能在保留期过后或已明确解除(例如,法律保留)后才能过期非当前版本。
例如,考虑以下存储桶,其中默认情况下为 45 天启用GOVERNANCE 模式锁定。
$ mc ls --versions play/locking-guide
[7D] 29B 62429eb1-9cb7-4dc5-b507-9cc23d0cc691 v3 PUT data.csv
[30D] 32B 78b3105a-02a1-4763-8054-e66add087710 v2 PUT data.csv
[60D] 23B c6b581ca-2883-41e2-9905-0a1867b535b8 v1 PUT data.csv
创建适用于当前对象(超过 7 天)的过期规则会导致为该对象生成删除标记。
$ mc ls --versions play/locking-guide
[0D] 0B acce329f-ad32-46d9-8649-5fe8bf4ec6e0 v4 DEL data.csv
[7D] 29B 62429eb1-9cb7-4dc5-b507-9cc23d0cc691 v3 PUT data.csv
[30D] 32B 78b3105a-02a1-4763-8054-e66add087710 v2 PUT data.csv
[60D] 23B c6b581ca-2883-41e2-9905-0a1867b535b8 v1 PUT data.csv
但是,适用于非当前对象(超过 7 天)的过期规则只有在配置的 WORM 锁定过期后才会生效。由于该存储桶具有 45 天的GOVERNANCE
保留设置,因此只有data.csv
的v1
版本被解锁,因此有资格删除。
教程
创建启用对象锁定的存储桶
您必须按照 S3 行为在创建存储桶时启用对象锁定。您可以使用 MinIO 控制台、MinIO mc
CLI 或使用 S3 兼容的 SDK 创建启用对象锁定的存储桶。
选择 MinIO 控制台的存储桶部分以访问存储桶创建和管理功能。从存储桶列表中选择存储桶行。您可以使用 搜索栏过滤列表。
单击创建存储桶按钮打开存储桶创建模态。切换对象锁定选择器以在存储桶上启用对象锁定。
使用mc mb
命令以及--with-lock
选项来创建启用对象锁定的存储桶。
mc mb --with-lock ALIAS/BUCKET
配置存储桶默认对象保留
您可以使用 MinIO 控制台、MinIO mc
CLI 或使用 S3 兼容的 SDK 配置对象锁定规则(“对象保留”)。
MinIO 支持设置存储桶默认和每个对象的保留规则。以下示例设置存储桶默认保留。对于每个对象的保留设置,请参阅您首选 SDK 使用的PUT
操作的文档。
选择 MinIO 控制台的存储桶部分以访问存储桶创建和管理功能。您可以使用 搜索栏过滤列表。
每个存储桶行都有一个管理按钮,它会打开该存储桶的管理视图。
从保留部分,选择已启用。此部分仅对使用启用对象锁定的存储桶创建的存储桶可见。
从设置保留配置模态中,设置所需的存储桶默认保留设置。
对于保留模式,选择COMPLIANCE或GOVERNANCE。
对于持续时间,选择天或年的保留持续时间单位。
对于保留有效期,设置 MinIO 在指定的存储桶保留模式下保存对象的时间长度。
使用mc retention set
命令以及--recursive
和--default
选项来设置存储桶的默认保留模式。
mc retention set --recursive --default MODE DURATION ALIAS/BUCKET
将
MODE
替换为COMPLIANCE或GOVERNANCE。将
DURATION
替换为对象锁定生效的持续时间。将
BUCKET
替换为要设置默认保留规则的存储桶的名称。
启用法律保留
您可以使用 MinIO 控制台、MinIO mc
CLI 或使用 S3 兼容的 SDK 启用或禁用对象的无限期法律保留。
您可以对已在COMPLIANCE或GOVERNANCE锁定下保存的对象进行法律保留。即使保留锁定过期,该对象也会在法律保留下保持 WORM 锁定状态。您或具有必要权限的其他用户必须显式解除法律保留以删除 WORM 锁定。
对象保留模式
MinIO 实施了以下S3 对象锁定模式
模式 |
摘要 |
---|---|
防止任何非特权用户会更改或修改对象或其锁定设置的操作。 具有 MinIO 会在配置的保留规则持续时间过后自动解除锁定。 |
|
防止任何会更改或修改对象或其锁定设置的操作。 没有 MinIO 用户可以修改对象或其设置,包括MinIO root用户。 MinIO 会在配置的保留规则持续时间过后自动解除锁定。 |
GOVERNANCE 模式
处于GOVERNANCE
锁定下的对象受到非特权用户的写入操作保护。
GOVERNANCE
锁定对象强制对锁定对象进行受管的不可变性,其中具有 s3:BypassGovernanceRetention
操作权限的用户可以修改锁定对象,更改保留期限,或完全解除锁定。绕过 GOVERNANCE
保留还需要在请求中设置 x-amz-bypass-governance-retention:true
标头。
MinIO GOVERNANCE
锁定在功能上与 S3 GOVERNANCE 模式 相同。
合规模式
处于 COMPLIANCE
锁定状态的对象受到所有用户的写入操作保护,包括 MinIO root 用户。
COMPLIANCE
锁定对象强制对锁定对象进行完全不可变性。在配置的保留期限过去之前,您不能更改或删除锁定。
MinIO COMPLIANCE
锁定在功能上与 S3 COMPLIANCE 模式 相同。
法律保留
处于法律保留状态的对象受到所有用户的写入操作保护,包括 MinIO root 用户。
法律保留是无限期的,并强制对锁定对象进行完全不可变性。只有具有 s3:PutObjectLegalHold
权限的特权用户才能设置或解除法律保留。
法律保留适用于对象级别。如果您为一组对象(例如存储桶的内容)启用法律保留,则该存储桶中随后创建的对象不受影响。
法律保留与 GOVERNANCE 模式 和 COMPLIANCE 模式 保留设置互补。处于法律保留以及GOVERNANCE/COMPLIANCE
保留规则下的对象将保持 WORM 锁定状态,直到解除法律保留并且规则过期。
对于 GOVERNANCE
锁定对象,法律保留会阻止修改对象,即使用户具有绕过保留所需的权限。