文档

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 部署的 FQDN

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

  • 同一行中的参数是相互依赖的。

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

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

参数

URL
必需

配置用于 AD/LDAP 集成的 MinIO 部署的 FQDN

例如

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

成功身份验证后要使用的访问密钥。省略此参数将让 MinIO 随机生成一个值。

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

需要 --secret-key

--secret-key
可选

成功身份验证后要使用的密钥。省略此参数将让 MinIO 随机生成一个值。

需要 --access-key

--policy
可选

指向用于该帐户的 JSON 格式 策略的文件路径。此策略_不能_授予超出已验证的 AD/LDAP 用户关联的权限的额外权限。

省略此参数将使用 AD/LDAP 用户策略。

--name
可选

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

--description
可选

为服务帐户创建描述。例如,您可以指定访问密钥存在的理由。

--expiry-duration
可选

访问密钥对在 #d#h#s 格式中有效的持续时间。

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

--expiry 互斥。

--expiry
可选

访问密钥到期后的日期。在 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