统一身份认证服务 IAM-获取IAM用户Token(使用密码+虚拟MFA):请求参数

时间:2024-08-21 15:43:13

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

该字段内容填为“application/json;charset=utf8”。

表3 请求Body参数

参数

是否必选

参数类型

描述

auth

Object

认证信息。

表4 auth

参数

是否必选

参数类型

描述

identity

Object

认证参数。

scope

Object

Token的使用范围,取值为project或domain,二选一即可。

说明:
  • 如果您将scope设置为domain,该Token适用于全局级服务;如果将scope设置为project,该Token适用于项目级服务。
  • 如果您将scope同时设置为project和domain,将以project参数为准,获取到项目级服务的Token。
  • 如果您将scope置空,将获取到全局级服务的Token。建议您按需要填写Token使用范围。
表5 auth.identity

参数

是否必选

参数类型

描述

methods

Array of strings

认证方法,该字段内容为["password", "totp"]。

取值范围:

  • password
  • totp

password

Object

用户密码认证信息。

说明:
  • user.name和user.domain.name可以在界面控制台“我的凭证”中查看,具体获取方法请参见:获取账号、 IAM 用户、项目、用户组、区域、委托的名称和ID。
  • 该接口提供了锁定机制用于防止暴力破解,调用时,请确保用户名密码正确,输错一定次数(管理员可设置该规则,方法请参见:账号锁定策略)将被锁定。

totp

Object

totp认证信息,仅在您已开启虚拟MFA方式的登录保护功能时需要填写该参数。

表6 auth.identity.password

参数

是否必选

参数类型

描述

user

Object

需要 获取Token 的IAM用户信息。

表7 auth.identity.password.user

参数

是否必选

参数类型

描述

domain

Object

IAM用户所属账号信息。了解账号与IAM用户的关系

name

String

IAM用户名。

password

String

IAM用户的登录密码。

说明:
  • 务必保证密码输入正确,避免获取Token失败。
  • 如果您是第三方系统用户,直接使用联邦认证的用户名和密码获取Token,系统会提示密码错误。请在华为云的登录页面,通过“忘记密码”功能,设置华为云账号密码,并在password中输入新设置的密码。
表8 auth.identity.password.user.domain

参数

是否必选

参数类型

描述

name

String

IAM用户所属账号名称,获取方式请参见:获取账号、IAM用户、项目、用户组、区域、委托的名称和ID

表9 auth.identity.totp

参数

是否必选

参数类型

描述

user

Object

IAM用户信息。该IAM用户已开启登录保护,并选择以虚拟MFA方式进行身份验证,开启/关闭登录保护方法请参见:敏感操作

表10 auth.identity.totp.user

参数

是否必选

参数类型

描述

id

String

已开启虚拟MFA方式的登录保护的IAM用户ID。

passcode

String

虚拟MFA验证码,在MFA应用程序中获取动态验证码,获取方法请参见:如何获取虚拟MFA验证码

说明:

务必保证验证码输入正确,避免获取Token失败。

表11 auth.scope

参数

是否必选

参数类型

描述

domain

Object

取值为domain时,表示获取的Token可以作用于全局服务,全局服务不区分项目或区域,如OBS服务。如需了解服务作用范围,请参考系统权限。domain支持id和name,二选一即可,建议选择“domain.id”。

project

Object

取值为project时,表示获取的Token可以作用于项目级服务,仅能访问指定project下的资源,如E CS 服务。如需了解服务作用范围,请参考系统权限。project支持id和name,二选一即可。

表12 auth.scope.domain

参数

是否必选

参数类型

描述

id

String

IAM用户所属账号ID,获取方式请参见:获取账号、IAM用户、项目、用户组、区域、委托的名称和ID

name

String

IAM用户所属账号名称,获取方式请参见:获取账号、IAM用户、项目、用户组、区域、委托的名称和ID

表13 auth.scope.project

参数

是否必选

参数类型

描述

id

String

IAM用户所属账号的项目id,获取方式请参见:获取账号、IAM用户、项目、用户组、区域、委托的名称和ID

name

String

IAM用户所属账号的项目名称,获取方式请参见:获取账号、IAM用户、项目、用户组、区域、委托的名称和ID

support.huaweicloud.com/api-iam/iam_03_0006.html