MinIO 身份管理插件设置
本页介绍如何通过 MinIO Identity Management Plugin 启用外部身份管理的相关设置。 有关如何使用这些设置的教程,请参阅 MinIO External Identity Management Plugin。
你可以通过以下方式建立或修改设置:
在启动或重启 MinIO Server 之前,在宿主机系统上定义 环境变量。 如何定义环境变量,请参考所用操作系统的文档。
使用
mc admin config set定义 配置项。
如果同时定义了环境变量和对应的配置项,MinIO 使用环境变量的值。
有些设置只有环境变量或配置项中的一种,而不是两者同时存在。
Important
每个配置项都会控制 MinIO 的基础行为和功能。 MinIO 强烈建议 先在 DEV 或 QA 等较低级别环境中测试配置变更,再应用到生产环境。
示例
配置 MinIO Identity Management Plugin 时,至少必须定义所有*必需*设置。 以下示例展示了最小必需配置。
MINIO_IDENTITY_PLUGIN_URL="https://authservice.example.net:8080/auth"
MINIO_IDENTITY_PLUGIN_ROLE_POLICY="ConsoleUser"
使用 mc admin config set 创建或更新身份管理插件配置。
identity_plugin url 参数为必填项。
其他可选参数以空白字符(” “)分隔的列表形式指定。
mc admin config set identity_plugin \
url="https://external-auth.example.net:8080/auth" \
role_policy="consoleAdmin" \
[ARGUMENT=VALUE] ...
设置
URL
必需
外部身份管理服务的 webhook endpoint
(https://authservice.example.net:8080/auth)。
角色策略
必需
指定要分配给已认证用户的 MinIO 策略 列表,多个策略之间 使用逗号分隔。
启用
可选
设置为 false 以禁用身份提供方配置。
如果设置为 false,应用程序将无法生成 STS 凭证,也无法通过已配置的提供方对 MinIO 进行身份验证。
默认为 true 或 “enabled”。
令牌
可选
提供给已配置 webhook endpoint 的认证令牌。
请以字符串形式指定受支持的 HTTP
Authentication scheme,
例如 "Bearer TOKEN"。
MinIO 会通过 HTTP
Authorization
头发送该令牌。
角色 ID
可选
指定 MinIO 用于为该 identity manager 生成 ARN 的唯一 ID。
在生成 ARN 时,MinIO 会自动在指定 ID 前添加 idmp- 前缀。
如果省略此项,MinIO 会自动生成该 ID,并将完整 ARN 输出到 server 日志中。
注释
可选
指定要附加到身份配置上的注释。