以腾讯上传用户在应用中的等级相关信息为例。接口详情在此【"http://wiki.open.qq.com/wiki/v3/user/get_info"】
在set_achievement这个接口中,接口参数包括openid, openkey, appid, pf, sig, user_attr, format
此接口最后的请求示例为
http://openapi.tencentyun.com/v3/user/set_achievement?
openid=B624064BA065E01CB73F835017FE96FA&
openkey=5F154D7D2751AEDC8527269006F290F70297B7E54667536C&
appid=2&
pf=qzone&
format=json&
user_attr=%7B%22level%22%3A10%7D&
sig=9999b41ad0b688530bb1b21c5957391c
这里除了sig其他参数都只是经过了URL编码而已,所以本文的重点也在如何生成sig。
在写代码的过程中我们也可以思考下为什么需要生成签名~
Step 1. 构造源串
第1步:将请求的URI路径进行URL编码(URI不含host,URI示例:/v3/user/get_info)。请开发者关注:URL编码注意事项,否则容易导致后面签名不能通过验证。
第2步:将除“sig”外的所有参数按key进行字典升序排列。 注:除非OpenAPI文档中特别标注了某参数不参与签名,否则除sig外的所有参数都要参与签名。
第3步:将第2步中排序后的参数(key=value)用&拼接起来,并进行URL编码。请开发者关注:URL编码注意事项,否则容易导致后面签名不能通过验证。 第4步:将HTTP请求方式(GET或者POST)以及第1步和第3步中的字符串用&拼接起来。
Step 2. 构造密钥
得到密钥的方式:在应用的appkey末尾加上一个字节的“&”,即appkey&
Step 3. 生成签名值
1. 使用HMAC-SHA1加密算法,使用Step2中得到的密钥对Step1中得到的源串加密。 (注:一般程序语言中会内置HMAC-SHA1加密算法的函数,例如PHP5.1.2之后的版本可直接调用hash_hmac函数。)
2. 然后将加密后的字符串经过Base64编码。 (注:一般程序语言中会内置Base64编码函数,例如PHP中可直接调用 base64_encode() 函数。)
3. 得到的签名值结果如下:
FdJkiDYwMj5Aj1UG2RUPc83iokk=
def getSig(cfg): strFilter = ".-_" codeUrlAddr = urllib2.quote(cfg[‘urlAddr‘],strFilter) urlData2 = sorted(cfg[‘urlData‘].iteritems(), key=lambda d:d[0]) codeStr0 = "" for (value01,value02) in urlData2: if codeStr0: codeStr0 += "&" + str(value01) + ‘=‘ + str(value02) else: codeStr0 += str(value01) + ‘=‘ + str(value02) codeStr1 = urllib2.quote(codeStr0) codeConn = cfg[‘urlMethod‘] + ‘&‘ + codeUrlAddr + ‘&‘ + codeStr1 sig = hmac.new(cfg[‘appkey‘] + ‘&‘, codeConn, hashlib.sha1).digest().encode(‘base64‘).rstrip() return sig def test(): urlData = { ‘openid‘ : ‘12345‘, ‘openkey‘ : ‘12345‘, ‘pf‘ : ‘wanba_ts‘, ‘appid‘ : 12345, ‘format‘ : ‘json‘, ‘user_attr‘ : ‘{"level":%d}‘ % 1234 } urlcfg = { ‘urlAddr‘ : ‘/v3/user/set_achievement‘, ‘urlMethod‘ : ‘GET‘, ‘appkey‘ : ‘ABCDWFSFFG‘, ‘urlData‘ : urlData } urlData[‘sig‘] = getSig(urlcfg)
第一步:将请求的URI路径进行URL编码(URI不含host,URI示例:/v3/user/get_info)。
urlCfg中urlAddr是第一步中的请求的URI路径。
URL编码规则:
签名验证时,要求对字符串中除了“-”、“_”、“.”之外的所有非字母数字字符都替换成百分号(%)后跟两位十六进制数。
十六进制数中字母必须为大写。
strFilter = ".-_" #不需要替换的字符 codeUrlAddr = urllib2.quote(cfg[‘urlAddr‘],strFilter)# url编码
第二步:将除“sig”外的所有参数按key进行字典升序排列。
urlData中就是第二步要求的sig参数外的所有参数,采用sorted方式进行排序。
urlData2 = sorted(cfg[‘urlData‘].iteritems(), key=lambda d:d[0])
第三步:将第2步中排序后的参数(key=value)用&拼接起来,并进行URL编码。
codeStr0 = "" for (value01,value02) in urlData2: if codeStr0: codeStr0 += "&" + str(value01) + ‘=‘ + str(value02) else: codeStr0 += str(value01) + ‘=‘ + str(value02) codeStr1 = urllib2.quote(codeStr0)
当我看到urllib.urlencode可以用来直接生成&进行拼接的时候非常开心,但是后来发现它会对value进行url编码。这与我们的要求是不符合的。所以采用了上面这种诡异的方式。
第四步:将HTTP请求方式(GET或者POST)以及第1步和第3步中的字符串用&拼接起来。
codeConn = cfg[‘urlMethod‘] + ‘&‘ + codeUrlAddr + ‘&‘ + codeStr1
Step2和Step3
sig = hmac.new(cfg[‘appkey‘] + ‘&‘, codeConn, hashlib.sha1).digest().encode(‘base64‘).rstrip()
这样就得到了sig的值,文档看起来有些复杂,但是一步步做下来其实难度也不大。
接下来就是按照文档要求进行数据请求啦~
urlStr1 = urllib.urlencode(urlData) url = urlHost + qqUserInfos[‘getPlayzoneUserInfoUrl‘] + ‘?‘ + urlStr1 request = urllib2.Request(url) result = json.loads(urllib2.urlopen(request).read())
在这个过程中不知道有没有小伙伴好奇为什么我的urlData里面的user_attr要像下面这样写
‘user_attr‘ : ‘{"level":%d}‘ % 1234
其实刚开始我是直接把{"level:1234}这个字典赋值给user_attr的。但是在操作的过程中发现由于python会把双引号自动变成单引号,导致生成的签名一直有问题。所以采用json格式来解决这个问题。
你以为本文这就完了?当!然!不!是!还有刚开始提出的问题没回答捏~
sooooo...为什么要生成签名?
The answer is "为了确定数据来源正确合法"
2.生成签名后,将用作签名的参数和签名一起传给腾讯服务器。
3.服务器将签名与我们的appid对应的appkey进行解密。
4.将传递过去的参数排序,然后与生成的参数进行对比。若数据一致则能保证数据真实。