对于每一次HTTP或者HTTPS协议请求,我们会根据访问中的签名信息验证访问请求者身份。具体由使用AccessKeyID和AccessKey Secret对称加密验证实现。
主账户和有权限的子用户可以新建AK密钥,操作如下:
CanonicalRequest = HTTPRequestMethod + '\n' + CanonicalURI + '\n' + CanonicalQueryString + '\n' + CanonicalHeaders + '\n' + SignedHeaders + '\n' + HexEncode(Hash(RequestPayload))
说明
在签名之前,首先要将请求正规化,目的是让签名计算过程无异议,其主要过程及伪代码如下:
HTTPRequestMethod
指代http请求的method,例如:GET等。
CanonicalURI
指代正规化后的URI。如果URI为空,那么使用"/"作为绝对路径。在火山引擎中绝大多数接口的URI都为"/"。
CanonicalQueryString
指代正规化后的Query String。对于Query String的正规化大致的过程如下:
CanonicalQueryString = "Action=ListUsers&Version=2020-04-01"
CanonicalHeaders
指代正规化后的Header。其中伪代码如下:
CanonicalHeaders = CanonicalHeadersEntry0 + CanonicalHeadersEntry1 + ... + CanonicalHeadersEntryN
其中
CanonicalHeadersEntry = Lowercase(HeaderName) + ':' + Trimall(HeaderValue) + '\n'
Lowcase代表将Header的名称全部转化成小写,Trimall表示去掉Header的值的前后多余的空格。
特别注意:最后需要添加"\n"的换行符。
SignedHeaders
代指参与签名的header名称。签名header是包含在正规化headers中名称列表,其目的是指明哪些header参与签名计算,从而忽略请求被proxy添加的额外header,其中host、x-date两个header如果存在则必须添加进来,伪代码如下:
SignedHeaders = Lowercase(HeaderName0) + ';' + Lowercase(HeaderName1) + ";" + ... + Lowercase(HeaderNameN)
RequestPayload
指代完整的请求的body。
签名字符串主要包含请求以及正规化请求的元数据信息,由签名算法、请求日期、信任状和正规化请求哈希值连接组成,伪代码如下:
StringToSign = Algorithm + '\n' + RequestDate + '\n' + CredentialScope + '\n' + HexEncode(Hash(CanonicalRequest))
Algorithm
指代签名的算法,目前火山引擎仅支持HMAC-SHA256的签名算法。
RequestDate
指代请求UTC时间,请使用如下格式:YYYYMMDD'T'HHMMSS'Z' 。
CredentialScope
指代信任状,格式为:YYYYMMDD/region/service/request。
CanonicalRequest
指代上一小节正规化请求的结果。
在计算签名前,首先从私有访问密钥(AccessKey Secret)派生出签名密钥(signing key),而不是直接使用私有访问密钥。具体计算过程如下:
kSecret = *Your AccessKey Secret* kDate = HMAC(kSecret, Date) kRegion = HMAC(kDate, Region) kService = HMAC(kRegion, Service) kSigning = HMAC(kService, "request")
Signature = HexEncode(HMAC(kSigning, StringToSign))
Authorization: HMAC-SHA256 Credential={CredentialScope}, SignedHeaders={SignedHeaders}, Signature={Signature}
说明
表达式中用{}括起来的代表上文计算出的中间过程。