文档

mc admin group

说明

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

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

仅在 MinIO 部署上使用 mc admin

MinIO 不支持将 mc admin 命令用于其他 S3 兼容服务, 无论这些服务声称与 MinIO 部署具有何种兼容性。

组与基于策略的访问控制

MinIO 使用 Policy-Based Access Control (PBAC) 对已成功在部署上 认证 的用户执行*授权*。每条策略都包含规则,用于规定该部署上 允许或拒绝的操作/资源。可以为一个组分配一个或多个 策略。属于该组的用户会继承该组已分配的策略。用户的 总权限集合包括其显式分配的策略,以及 通过组成员关系继承的策略。

新创建的组默认*不*包含任何策略。要配置组的已分配策略,请使用 mc admin policy attach 命令。

有关 MinIO 用户和组的更多信息,请参见 用户管理组管理。有关 MinIO 策略的更多信息, 请参见 MinIO Policy Based Access Control

Deny 会覆盖 Allow

MinIO 遵循 IAM 标准:在同一操作或资源上,Deny 规则会覆盖 Allow 规则。 例如,如果某个用户显式分配的策略对某个操作/资源包含 Allow 规则, 而该用户所属的某个组所分配策略对同一操作/资源包含 Deny 规则, 则 MinIO 只会应用 Deny 规则。

有关 IAM 策略评估逻辑的更多信息,请参见 IAM 文档中的 Determining Whether a Request is Allowed or Denied Within an Account

示例

创建新组

使用 mc admin group add 在兼容 S3 的主机上创建新组:

mc admin group add ALIAS GROUPNAME MEMBER [MEMBER...]
  • ALIAS 替换为兼容 S3 主机的 alias

  • GROUPNAME 替换为要创建的 组名。

  • MEMBER 替换为 S3 主机上 至少 一个 用户。多个成员可按列表方式指定: MEMBER1 MEMBER2 MEMBER3

列出可用组

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

mc admin group ls ALIAS

查看组详情

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

mc admin group info ALIAS GROUPNAME

删除组

使用 mc admin group rm 从兼容 S3 主机删除组:

mc admin group rm ALIAS GROUPNAME

禁用组

使用 mc admin group disable 禁用兼容 S3 主机上的组:

mc admin group disable ALIAS GROUPNAME

启用组

使用 mc admin group enable 启用兼容 S3 主机上的组:

mc admin group enable ALIAS 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 部署的 alias,命令会在该部署上 向新建或现有组添加用户

GROUPNAME

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

组名不能包含 ``=``(等号)或 ``,``(逗号)字符。

MEMBERS

要添加到组中的用户名。

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

mc admin group info

返回目标部署上该组的详细信息,例如组内所有 用户 以及分配的 策略。命令语法如下:

mc admin group info TARGET GROUPNAME

该命令接受以下参数:

TARGET

已配置 MinIO 部署的 alias,用于从该部署中 获取组信息。

GROUPNAME

组名。

mc admin group ls, list

列出目标 MinIO 部署上的所有组。命令语法如下:

mc admin group ls TARGET

该命令接受以下参数:

TARGET

已配置 MinIO 部署的 alias,用于从该部署中 获取组列表。

mc admin group rm, remove

删除目标 MinIO 部署上的组。删除组*不会* 删除该组中的任何成员用户。请使用 mc admin user rm 从组中移除用户。

命令语法如下:

mc admin group rm TARGET GROUPNAME

该命令接受以下参数:

TARGET

已配置 MinIO 部署的 alias,命令会在该部署上 删除组。

GROUPNAME

要删除的组名。

mc admin group enable

启用目标 MinIO 部署上的组。用户只能从已启用组继承 策略。 组在创建时默认处于启用状态。命令语法如下:

mc admin group enable TARGET GROUPNAME

该命令接受以下参数:

TARGET

已配置 MinIO 部署的 alias,命令会在该部署上 启用组。

GROUPNAME

要启用的组名。

mc admin group disable

禁用目标 MinIO 部署上的组。用户不能从已禁用组继承 策略。命令语法如下:

mc admin group disable TARGET GROUPNAME

该命令接受以下参数:

TARGET

已配置 MinIO 部署的 alias,命令会在该部署上 禁用组。

GROUPNAME

要禁用的组名。