MinIO 对象锁定
概述
MinIO 对象锁定(“对象保留”)对 版本化对象 强制执行一次写入多次读取 (WORM) 不变性,以防止删除。MinIO 支持 基于时间的对象保留 和 无限期法律保留。
MinIO 对象锁定提供关键数据保留合规性,并根据 Cohasset Associates 满足 SEC17a-4(f)、FINRA 4511(C) 和 CFTC 1.31(c)-(d) 的要求。
MinIO 对象锁定与 AWS S3 的功能和 API 兼容。本页面总结了 MinIO 实现的对象锁定/保留概念。有关更多资源,请参阅 AWS S3 文档中的 S3 对象锁定工作原理。
您只能在创建存储桶时启用对象锁定,如 S3 行为 所示。您无法在创建时没有启用锁定的存储桶上启用对象锁定。然后,您可以随时配置对象保留规则。对象锁定需要 版本控制 并且会隐式启用该功能。
与版本控制的交互
在 WORM 锁定下保存的对象在锁过期或显式解除之前是不可变的。锁定针对每个对象版本,每个版本独立不可变。
如果应用程序对锁定对象执行非版本化删除操作,则该操作将生成一个 删除标记。尝试显式删除任何 WORM 锁定对象都将失败并报错。删除标记*不*符合 WORM 锁定保护的条件。有关更多信息,请参阅 S3 文档中的 管理删除标记和对象生命周期。
例如,考虑以下存储桶,默认情况下启用了 治理模式 锁定
$ 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 天
$ 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 控制台的 存储桶 部分,以访问存储桶创建和管理功能。您可以使用 搜索 条来过滤列表。
每个存储桶行都带有一个 管理 按钮,该按钮将打开该存储桶的管理视图。
在 保留 部分中,选择 已启用。此部分仅对启用了对象锁定的存储桶可见。
在 设置保留配置 模态中,设置所需的存储桶默认保留设置。
使用 mc retention set
命令和 --recursive
和 --default
选项来设置存储桶的默认保留模式
mc retention set --recursive --default MODE DURATION ALIAS/BUCKET
启用法律保留
您可以使用 MinIO 控制台、MinIO mc
CLI 或使用 S3 兼容的 SDK 来启用或禁用对象的无限期法律保留。
您可以对已在 合规性 或 治理 锁定下保存的对象进行法律保留。即使保留锁定过期,该对象也会在法律保留下保持 WORM 锁定。您或另一个具有必要权限的用户必须显式解除法律保留,才能移除 WORM 锁定。
对象保留模式
MinIO 实施了以下 S3 对象锁定模式
模式 |
摘要 |
---|---|
防止任何非特权用户对对象或其锁定设置进行更改或修改的操作。 具有存储桶或对象 配置的保留规则持续时间过后,MinIO 将自动解除锁定。 |
|
防止任何更改或修改对象或其锁定设置的操作。 没有 MinIO 用户可以修改对象或其设置,包括 MinIO root 用户。 配置的保留规则持续时间过后,MinIO 将自动解除锁定。 |
治理模式
处于 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
锁定的对象,即使用户具有绕过保留所需的权限,法律保留也会阻止修改对象。