`mc admin group`

描述

该 mc admin group 命令管理 MinIO 部署上的组。

一个组是用户的集合。每个组可以分配一个或多个策略，这些策略明确列出了组成员被允许或拒绝访问的操作和资源。组提供了一种简化的方法来管理具有共同访问模式和工作负载的用户之间的共享权限。

仅在 MinIO 部署中使用 mc admin

MinIO 不支持将 mc admin 命令与其他与 S3 兼容的服务一起使用，无论它们声称与 MinIO 部署的兼容性如何。

组和基于策略的访问控制

MinIO 使用基于策略的访问控制 (PBAC) 来支持已成功身份验证到部署的用户授权。每个策略都包含规定部署上允许或拒绝的操作/资源的规则。您可以将一个或多个策略分配给一个组。属于该组的用户将继承该组的分配策略。用户的权限总集包括其显式分配的策略以及通过组成员身份继承的任何策略。

新创建的组默认没有策略。要配置组的分配策略，请使用 mc admin policy attach 命令。

有关 MinIO 用户和组的更多信息，请参阅用户管理和组管理。有关 MinIO 策略的更多信息，请参阅 MinIO 基于策略的访问控制。

Deny 覆盖 Allow

MinIO 遵循 IAM 标准，其中 Deny 规则会覆盖同一操作或资源上的 Allow 规则。例如，如果用户具有显式分配的策略，其中包含针对操作/资源的 Allow 规则，而其某个组具有分配的策略，其中包含针对该操作/资源的 Deny 规则，则 MinIO 将仅应用 Deny 规则。

有关 IAM 策略评估逻辑的更多信息，请参阅 IAM 文档上的确定帐户内请求是否允许或拒绝。

示例

创建新组

使用 mc admin group add 创建一个新的与 S3 兼容的主机组

mc admin group add ALIAS GROUPNAME MEMBER [MEMBER...]

将 ALIAS 替换为与 S3 兼容的主机的 别名。
将 GROUPNAME 替换为要创建的组的名称。
将 MEMBER 替换为 S3 主机上的至少一个 用户。将多个成员指定为列表：MEMBER1 MEMBER2 MEMBER3

列出可用组

使用 mc admin group ls 列出与 S3 兼容的主机上的所有组

mc admin group ls ALIAS

将 ALIAS 替换为与 S3 兼容的主机的 别名。

查看组详细信息

使用 mc admin group info 查看与 S3 兼容的主机上的详细组信息

mc admin group info ALIAS GROUPNAME

将 ALIAS 替换为与 S3 兼容的主机的 别名。
将 GROUPNAME 替换为组的名称。

删除组

使用 mc admin group rm 从与 S3 兼容的主机中删除一个组

mc admin group rm ALIAS GROUPNAME

将 ALIAS 替换为与 S3 兼容的主机的 别名。
将 GROUPNAME 替换为组的名称。

禁用组

使用 mc admin group disable 在与 S3 兼容的主机上禁用一个组

mc admin group disable ALIAS GROUPNAME

将 ALIAS 替换为与 S3 兼容的主机的 别名。
将 GROUPNAME 替换为组的名称。

启用组

使用 mc admin group enable 在与 S3 兼容的主机上启用一个组

mc admin group enable ALIAS GROUPNAME

将 ALIAS 替换为与 S3 兼容的主机的 别名。
将 GROUPNAME 替换为组的名称。

快速参考

mc admin group add TARGET GROUPNAME MEMBERS: 将用户添加到 MinIO 部署中的组。如果组不存在，则创建该组。
mc admin group info TARGET GROUPNAME: 返回 MinIO 部署中某个组的详细信息。
mc admin group ls TARGET: 返回 MinIO 部署中所有组的列表。
mc admin group rm TARGET GROUPNAME: 删除 MinIO 部署中的一个组。
mc admin group enable TARGET GROUPNAME: 启用 MinIO 部署中的一个组。用户只能继承分配给已启用组的策略。
mc admin group disable TARGET GROUPNAME: 禁用 MinIO 部署中的一个组。用户无法继承分配给已禁用组的策略。

语法

mc admin group add

将现有用户添加到组中。如果该组不存在，则该命令会创建该组。该命令具有以下语法

mc admin group add TARGET GROUPNAME MEMBERS

该命令接受以下参数

TARGET: 已配置的 MinIO 部署的别名，该命令在其中将用户添加到新组或现有组中。

GROUPNAME

组的名称。如果该组尚不存在，则该命令会创建该组。使用mc admin group ls查看部署中现有的组。

组名不能包含字符=（等号）或,（逗号）。

MEMBERS

要添加到组中的用户的名称。

用户*必须*存在于TARGET MinIO 部署中。使用mc admin user ls查看部署中可用的用户。

mc admin group info

返回目标部署中组的详细信息，例如组中所有具有成员资格的用户以及分配的策略。该命令具有以下语法

mc admin group info TARGET GROUPNAME

该命令接受以下参数

TARGET: 已配置的 MinIO 部署的别名，从中检索组信息。

GROUPNAME: 组的名称。

mc admin group ls, list

列出目标 MinIO 部署中的所有组。该命令具有以下语法

mc admin group ls TARGET

该命令接受以下参数

TARGET: 已配置的 MinIO 部署的别名，从中检索组。

mc admin group rm, remove

删除目标 MinIO 部署中的一个组。删除组*不会*删除组中任何具有成员资格的用户。使用mc admin user rm从组中删除用户。

该命令具有以下语法

mc admin group rm TARGET GROUPNAME

该命令接受以下参数

TARGET: 已配置的 MinIO 部署的别名，在其中删除组。

GROUPNAME: 要删除的组的名称。

mc admin group enable

启用目标 MinIO 部署中的组。用户只能从已启用的组继承策略。默认情况下，组在创建时处于启用状态。该命令具有以下语法

mc admin group enable TARGET GROUPNAME

该命令接受以下参数

TARGET: 已配置的 MinIO 部署的别名，在其中启用组。

GROUPNAME: 要启用的组的名称。

mc admin group disable

禁用目标 MinIO 部署中的组。用户无法从已禁用的组继承策略。该命令具有以下语法

mc admin group disable TARGET GROUPNAME

该命令接受以下参数

TARGET: 已配置的 MinIO 部署的别名，在其中禁用组。

GROUPNAME: 要禁用的组的名称。