获取联邦用户的临时访问密钥和securitytoken

功能介绍

该接口可以用于通过token来获取临时AK/SK和securitytoken。临时AK/SK和securitytoken是系统颁发给IAM用户的临时访问令牌，有效期可在15分钟至24小时范围内设置，过期后需要重新获取。临时AK/SK和securitytoken遵循权限最小化原则。

该接口可以使用全局区域的Endpoint和其他区域的Endpoint调用。IAM的Endpoint请参见：地区和终端节点。

使用获取到的临时AK/SK和securitytoken作为凭证访问云服务，临时AK/SK和securitytoken两者必须同时使用，请求头中需要添加“x-security-token”字段，使用方法详情请参考：使用临时AK/SK做签名。

调试

您可以在API Explorer中调试该接口。

URI

POST /v3.0/OS-CREDENTIAL/securitytokens

请求参数

 "Condition": {
              "StringEquals": {
                "g:DomainName": [
                  "DomainNameExample"
                ]
              }
            }

响应参数

"expires_at": "2020-01-08T02:56:19.587000Z"

请求示例

• 填写"token"参数。包含tokenId（即token）和临时访问密钥和securitytoken的有效期。

  POST https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/securitytokens

  {
      "auth": {
          "identity": {
              "methods": [
                  "token"
              ],
              "token": {
                  "id": "MIIEIgYJKoZIhvc...",
                  "duration_seconds": "900"
              }
          }
      }
  }

• 不填写“token”参数（请求头中需要X-Auth-Token）。

  POST https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/securitytokens

  {
      "auth": {
          "identity": {
              "methods": [
                  "token"
              ]
          }
      }
  }

• 填写“policy”参数。即用户自定义策略的信息，用于限制获取到的临时访问密钥和securitytoken的权限（当前仅适用限制OBS服务的权限）。如果填写此参数，则临时访问密钥和securitytoken的权限为：原token具有的权限和policy参数限制的权限交集。

  POST https://iam.myhuaweicloud.com/v3.0/OS-CREDENTIAL/securitytokens

  {
    "auth": {
      "identity": {
        "methods": [
          "token"
        ],
        "policy": {
          "Version": "1.1",
          "Statement": [
            {
              "Effect": "Allow",
              "Action": [
                "obs:object:GetObject"
              ],
              "Resource": [
                "OBS:*:*:object:*"
              ],
              "Condition": {
                "StringEquals": {
                  "g:DomainName": [
                    "DomainNameExample"                    //示例，表示限制条件值，根据实际情况填写
                  ]
                }
              }
            }
          ]
        },
        "token": {
          "duration_seconds": 900
        }
      }
    }
  }

响应示例

状态码为 201 时:

创建成功。

{
    "credential": {
        "access": "NZFAT5VNWEJDGZ4PZ...",
        "expires_at": "2020-01-08T03:50:07.574000Z",
        "secret": "riEoWsy3qO0BvgwfkoLVgCUvzgpjBBcvdq...",
        "securitytoken": "gQpjbi1ub3J0aC00jD4Ej..."
    }
}

返回值

错误码

无