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...]
列出可用组
使用 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
要添加到组中的用户名。
该用户*必须*存在于
TARGETMinIO 部署上。可使用mc admin user ls查看部署上的可用 用户。
- mc admin group info
返回目标部署上该组的详细信息,例如组内所有 用户 以及分配的 策略。命令语法如下:
mc admin group info TARGET GROUPNAME
该命令接受以下参数:
- TARGET
已配置 MinIO 部署的
alias,用于从该部署中 获取组信息。
- 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,命令会在该部署上 删除组。