MinIO 身份管理插件设置
本页介绍如何通过 MinIO Identity Management Plugin 启用外部身份管理的相关设置。 有关如何使用这些设置的教程,请参阅 MinIO External Identity Management Plugin。
你可以通过以下方式建立或修改设置:
- 在启动或重启 MinIO Server 之前,在宿主机系统上定义 环境变量。 如何定义环境变量,请参考所用操作系统的文档。
- 使用
mc admin config set定义 配置项。
如果同时定义了环境变量和对应的配置项,MinIO 使用环境变量的值。
有些设置只有环境变量或配置项中的一种,而不是两者同时存在。
重要
每个配置项都会控制 MinIO 的基础行为和功能。 MinIO 强烈建议 先在 DEV 或 QA 等较低级别环境中测试配置变更,再应用到生产环境。
示例
配置 MinIO Identity Management Plugin 时,至少必须定义所有必需设置。 以下示例展示了最小必需配置。
MINIO_IDENTITY_PLUGIN_URL="https://authservice.example.net:8080/auth"
MINIO_IDENTITY_PLUGIN_ROLE_POLICY="ConsoleUser"
identity_plugin
mc-conf
使用 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
必需
MINIO_IDENTITY_PLUGIN_URL
envvar
identity_plugin url
mc-conf
外部身份管理服务的 webhook endpoint (https://authservice.example.net:8080/auth)。
角色策略
必需
MINIO_IDENTITY_PLUGIN_ROLE_POLICY
envvar
identity_plugin role_policy
mc-conf
指定要分配给已认证用户的 MinIO 策略 列表,多个策略之间 使用逗号分隔。
启用
可选
此设置不提供环境变量选项。
identity_plugin enabled
mc-conf
设置为 false 以禁用身份提供方配置。
如果设置为 false,应用程序将无法生成 STS 凭证,也无法通过已配置的提供方对 MinIO 进行身份验证。
默认为 true 或 “enabled”。
令牌
可选
MINIO_IDENTITY_PLUGIN_TOKEN
envvar
identity_plugin token
mc-conf
提供给已配置 webhook endpoint 的认证令牌。
请以字符串形式指定受支持的 HTTP Authentication scheme, 例如 "Bearer TOKEN"。 MinIO 会通过 HTTP Authorization 头发送该令牌。
角色 ID
可选
MINIO_IDENTITY_PLUGIN_ROLE_ID
envvar
identity_plugin role_id
mc-conf
指定 MinIO 用于为该 identity manager 生成 ARN 的唯一 ID。 在生成 ARN 时,MinIO 会自动在指定 ID 前添加 idmp- 前缀。
如果省略此项,MinIO 会自动生成该 ID,并将完整 ARN 输出到 server 日志中。
注释
可选
MINIO_IDENTITY_PLUGIN_COMMENT
envvar
identity_plugin comment
mc-conf
指定要附加到身份配置上的注释。
本页部分内容改编自 MinIO 对象存储文档,© 2020–至今 MinIO, Inc.,依据 CC BY 4.0 授权,由 Silo 项目转换与维护。归属与署名
本页为非官方中文翻译。如与英文原文有出入,以英文原文为准。