中文文档

mc idp ldap accesskey create-with-login

在 mc 版本加入: RELEASE.2024-04-18T16-45-29Z

简介

mc idp ldap accesskey create-with-login 使用交互式终端提示与外部 AD/LDAP 服务器进行身份验证,并生成访问密钥供 MinIO 使用。

下面的示例会提示用户提供 AD/LDAP 凭据。 然后,它会使用与该 AD/LDAP 用户相关的一个或多个策略生成一个新的访问密钥对。

mc idp ldap accesskey create-with-login https://minio.example.net/

命令语法如下:

mc [GLOBALFLAGS] idp ldap accesskey create-with-login        \
                                 URL                         \
                                 [--access-key <value>]      \
                                 [--secret-key <value>]      \
                                 [--policy <value>]          \
                                 [--name <value>]            \
                                 [--description <value>]     \
                                 [--expiry <value>]          \
                                 [--expiry-duration <value>]
  • URL 替换为为 AD/LDAP 集成而配置的 MinIO 部署的 :abbr: FQDN(完全合格域名)

  • 方括号 [] 表示可选参数。

  • 参数在同一行表示它们是相互依赖的。

  • 使用管道 | 运算符分隔的参数是相互排斥的。

在终端/壳中运行命令之前,将示例复制到文本编辑器中并按需进行修改。

参数

URL
Required

为 AD/LDAP 集成而配置的 MinIO 部署的 :abbr: FQDN(完全合格域名)

例如:

mc idp ldap accesskey create-with-login https://minio.example.net
--access-key
Optional

验证成功后使用的访问密钥。 如果省略,则让 MinIO 随机生成一个值。

访问密钥不能包含字符 = (等号)或 , (逗号)。

Requires --secret-key

--secret-key
Optional

验证成功后使用的密匙。 如果省略,则让 MinIO 随机生成一个值。

Requires --access-key

--policy
Optional

账户要使用的 JSON 格式 policy 的文件路径。 该策略 _cannot_ 授予与已通过身份验证的 AD/LDAP 用户相关的权限之外的额外权限。

省略以使用 AD/LDAP 用户策略。

--name
Optional

用于创建的访问密钥的可读名称。

--description
Optional

为服务帐户创建说明。 例如,您可以指定访问密钥存在的原因。

--expiry-duration
Optional

访问密钥对以 #d#h#s 格式使用时保持有效的时间长度。

例如, 7d24h5d12h30s 都是有效字符串。

--expiry 相互排斥。

--expiry
Optional

访问密钥过期的日期。 以 YYYY-MM-DD 格式输入日期。

例如,要使证书在 2024 年 12 月 31 日后过期,请输入 2024-12-31

--expiry-duration 相互排斥。

全局标志

此命令支持任何 全局标志

行为规范

S3 兼容性

mc 命令行工具是为了与 AWS S3 API 兼容而构建的,并且已经过测试, 以确保在与 MinIO 和 AWS S3 配合使用时,功能和行为符合预期。

MinIO 不对其他 S3 兼容服务提供任何保证,因为它们的 S3 API 实现是 未知的,因此不受支持。尽管 mc 命令 可能 如文档中所 述工作,但任何此类使用都是您自己的风险。

示例

为已通过验证的用户创建新的访问密钥对

下面的命令创建了一个新的访问密钥对,与当前通过身份验证的 minio 别名用户一起使用。 该命令会输出随机生成的访问密钥和秘密密钥。

mc idp ldap accesskey create-with-login https://minio.example.net

使用自定义访问密钥和秘钥创建新的访问密钥对

下面的命令创建了一个新的访问密钥对,其中包含访问密钥和秘钥,您为当前在 minio 别名上验证的用户指定了访问密钥和秘钥。

mc idp ldap accesskey create-with-login https://minio.example.net/ --access-key my-access-key-change-me --secret-key my-secret-key-change-me

创建新的访问密钥对,24 小时后失效

下面的命令创建了一个新的访问密钥对,与当前通过身份验证的 minio 别名用户一起使用。 证书在 24 小时后失效。

该命令会输出随机生成的访问密钥和秘密密钥。

mc idp ldap accesskey create-with-login https://minio.example.net --expiry-duration 24h

创建一个新的访问密钥对,在某个日期后过期

下面的命令创建了一个新的访问密钥对,与当前通过身份验证的 minio 别名用户一起使用。 全权证书将于 2025 年 2 月 28 日到期。

该命令会输出随机生成的访问密钥和秘密密钥。

mc idp ldap accesskey create-with-login https://minio.example.net --expiry 2025-02-28
Join Slack 商业支持购买咨询