阿里云-访问控制服务API文档-D.docxVIP

访问控制

STSAPI文档

访问控制/STSAPI

访问控制/STSAPI文档

PAGE10

PAGE10

STSAPI文档

STS介绍

阿里云STS(SecurityTokenService)是为阿里云账号（或RAM用户）提供短期访问权限管理的云服务。通过STS，您可以为联盟用户（您的本地账号系统所管理的用户）颁发一个自定义时效和访问权限的访问凭证。联盟用户可以使用STS短期访问凭证直接调用阿里云服务API，或登录阿里云管理控制台操作被授权访问的资源。

访问点

STS的默认访问点地址是:，用户必须使用https接入访问点。

术语表

术语

中文

说明

Federatedidentity

联盟用户身份

联盟用户的身份认证由客户自己管理

Policy

访问策略

用来描述授权策略的一种描述语言

Grantor

授权者

授权令牌的颁发者(云账号或RAM用户)

Name

被授权者

授权令牌的使用者(即联盟用户)

调用方式请求结构

服务地址

STS服务的API接入地址为

通信协议

为了保证通信的安全性，STS服务仅支持使用HTTPS安全通道发送请求。

HTTP请求方法

支持HTTPGET/POST方法发送请求，这种方式下请求参数需要包含在请求的URL中。(GET请求最大不得超过4KB,POST请求最大不得超过10MB)

请求参数

每个请求都需要指定要执行的操作，即Action参数（例如AddUser），以及每个操作接口都需要包含的公共请求参数和指定操作接口所特有的请求参数。

字符编码

请求及返回结果都使用UTF-8字符集进行编码。

公共请求参数

Format

名称:Format

类型:String

必须:否

说明:返回值的类型，支持JSON与XML，默认为XML。

Version

名称:Version

类型:String

必须:是

说明:API版本号，为日期形式：YYYY-MM-DD，本版本对应为2015-04-01。

AccessKeyId

名称:AccessKeyId

类型:String

必须:是

说明:阿里云颁发给用户的访问服务所用的密钥ID。

Signature

名称:Signature

类型:String

必须:是

说明:签名结果串，关于签名的计算方法，请参见签名机制。

SignatureMethod

名称:SignatureMethod

类型:String

必须:是

说明:签名方式，目前仅支持HMAC-SHA1。

SignatureVersion

名称:SignatureVersion

类型:String

必须:是

说明:签名算法版本，目前版本是1.0

SignatureNonce

名称:SignatureNonce

类型:String

必须:是

说明:唯一随机数，用于防止网络重放攻击。用户在不同请求间要使用不同的随机数值。

Timestamp

名称:Timestamp

类型:String

必须:是

说明:请求的时间戳。日期格式按照ISO8601标准表示，并需要使用UTC时间。格式为：YYYY-MM-

DDThh:mm:ssZ例如，2013-01-10T12:00:00Z（为北京时间2013年1月10日20点0分0秒）

请求示例

/

/

?Format=xmlVersion=2015-04-01

Signature=Pc5WB8gokVn0xfeu%2FZV%2BiNM1dgI%3DSignatureMethod=HMAC-SHA1SignatureNonce=15215528852396SignatureVersion=1.0

AccessKeyId=key-testTimestamp=2012-06-01T12:00:00Z

…

公共返回参数

用户发送的每次接口调用请求，无论成功与否，系统都会返回一个唯一识别码RequestId给用户。

示例

?xmlversion=1.0encoding=utf-8?!-结果的根结点

?xmlversion=1.0encoding=utf-8?

!-结果的根结点--

接口名称+Response

!-返回请求标签--

RequestId4C467B38-3910-447D-87BC-AC049166F216/RequestId

!-返回结果数据--

/接口名称+Response

JSON示例

{

{

RequestId:4C467B38-3910-447D-87BC-AC049166F216

/*返回结果数据*/

}

返回结果处理

调用API服务后返回数据采用统一格式，返回的HTTP状态码为2xx，代表调用成功；返回4xx或5xx的HTTP状态码代表调