obs签名机制概述-九游平台

客户端

1

构造http请求

用户根据自身诉求构建http请求消息，一个完整的api调用请求包含请求uri、请求方法、请求消息头、请求消息体（可选），如何构造api请求详见。

2

计算签名s

根据构造的http请求和用户访问密钥计算签名s。您可以根据签名携带方式选择一种签名计算方式：

• header携带时如何计算签名？
• url携带时如何计算签名？
• 表单时的如何计算签名？

3

将签名s添加到请求消息中

将签名添加到请求消息中，消息携带签名的方式有3种：

• 添加到http请求的authorization header头域
• 添加到url的query参数
• post上传（表单上传）情况下，添加到表单

4

发送携带签名s的api调用请求

将携带签名信息的请求发送给服务端。

obs服务端

5

接收调用请求

接受客户端的调用请求。

6

验证签名

服务端根据接收到的http请求和用户访问密钥再次计算签名s'，比较s'与客户端计算的签名s是否一致，如果一致则签名验证成功，不一致则验证失败。

7

返回api调用结果

• 如果验证成功则继续执行api，然后向客户端返回api执行结果。
• 如果验证失败则通知客户端验证失败，状态码为403 forbidden，错误码为signaturedoesnotmatch。定位和修复签名不匹配行为请参见

客户端

8

接收服务端响应

客户端接收服务端响应。

适用场景

一般情况下，推荐您使用在header中携带签名。

使用在url中签名的方式，会将授权的数据在过期时间内暴露在互联网上，具有一定的风险。该方式适用于在不提供给第三方访问密钥的情况下，让第三方能用预签发的url来进行身份认证，并执行预定义操作。

如何您想通过浏览器访问obs，建议您使用url携带签名，

是否支持设置expires

否

是

是否支持设置date

是

否

常用api

所有api接口

get、put

时间格式

通过date头域表示请求生成时间，date必须为rfc 1123格式的gmt时间。

如果date与当前服务器的时间相差超过15分钟时，则服务端返回403，认为请求已失效。

expires字段表示临时授权失效的时间，单位：秒。超过该时间后，url签名失效。

signature是否需要url编码

否

是