原文博客:http://www.cnblogs.com/hll2008/archive/2011/01/03/1924952.html
对于界面及数据库使用就不在啰嗦,只诠释下授权验证部分。
新浪微博授权支持Oauth1.0 和Oauth2.0 ,后者对前者在过程中有所改变,详细信息可参考:
Oauth1.0 http://open.weibo.com/wiki/Oauth
Oauth2.0 http://open.weibo.com/wiki/index.php?title=Oauth2&redirect=no
授权机制:
大部分REST API的访问如发表微博,获取私信都需要用户身份。目前用户身份鉴权有OAuth和Basic Auth(仅用于开发者调试接口)两种方式。
OAuth
HTTP普通鉴权(Basic Authentication)方式
curl -u user:password -d "source=10001&status=api test" http://api.t.sina.com.cn/statuses/update.xml
oauth/request_token
- oauth_consumer_key: 创建应用时生成的APP KEY。
- oauth_signature_method: 签名方法,建议使用“HMAC-SHA1”。
- oauth_timestamp:时间戳。生成Base String时的时间戳。
- oauth_nonce:单次值,一个随机字符串,防止重复攻击。该字段只支持ASCII码的字符。
- oauth_version : OAuth协议版本。填写“1.0”。
- oauth_signature:签名值,是由根据上面的5个参数生成的 Base String经HMAC-SHA1算法计算得出。
httpMethod + "&" + url_encode( base_uri ) + "&" + sorted_query_params.each { | k, v | url_encode ( k ) + "=" + url_encode ( v ) }.join("&")
返回值
oauth_token=8ldIZyxQeVrFZXFOZH5tAwj6vzJYuLQpl0WUEYtWc&oauth_token_secret=x6qpRnlEmW9JbQn4PQVVeVG8Z
获取request token
request token是进行用户认证的第一步。这一步主要有两个目的:consumer secret - "MCD8BKwGdgPHvAuvgvz4EQpqDAtx89grbuNMRd7Eh98" 这个做什么用 ?第一步,用上文提到的算法形成BASE STRING。需要注意的是callback在URL中包含请求参数,由于参数只CALLBACK URL的一部分,所以并不需要将其提出成为独立的参数。 URL必须按照单个字符串来考虑。生成的BASE STRING如下:
oauth_callback - http://localhost:3005/the_dance/process_callback?service_provider_id=11 授权后的重定向的URL
oauth_consumer_key - GDdmIQH6jhtmLUypg82g 创建应用时生成的APP KEY。
oauth_nonce - QP70eNmVz8jvdPevU3oJD2AfF7R7odC2XJcn4XlZJqk 单次值,一个随机字符串,防止重复攻击
oauth_signature_method - HMAC-SHA1 签名方法
oauth_timestamp - 1272323042 时间戳
oauth_version - OAuth协议版本
我的理解:请求时,使用consumer_secret作为密钥对请求参数进行加密,而传输过程中只传输公钥(consumer_key),所以在接口参数中只有oauth_consumer_key,而没有包含上文提到的consumer_secret。
比如,文中提到的oauth_callback等参数作为字符基串,生成oauth_signature:签名值,再作为请求参数传输。
POST&https://api.t.sina.com.cn/oauth/request_token&oauth_callback=http://loca
8wUi7m5HFQy76nowoCThusfgB+Q=
OAuth oauth_nonce="QP70eNmVz8jvdPevU3oJD2AfF7R7odC2XJcn4XlZJqk",
oauth_callback="http://localhost:3005
oauth_token=8ldIZyxQeVrFZXFOZH5tAwj6vzJYuLQpl0WUEYtWc&oauth_token_secret=x6qpRnlEmW9JbQn4PQVVeVG8ZLPEx6A0TOebgwcuA&oauth_callback_confirmed=true
用户认证
- oauth_token 上一步获(即:oauth/request_token接口调用)取到的oauth token
- oauth_callback, 需要进行url encode
-
display,定义页面调用类型,目前我们提供了6种调用类型
Android,iPhone调用:display=mobile
wap访问页面自动调用:display=wap 我们会根据信息头来判断是wap1.2还是wap2.0
wap1.2页面调用:display=wap1.2 供wap1.2访问
wap2.0页面调用:display=wap2.0 供wap2.0访问
- userId 新浪通行证账户名
- passwd 密码
使用说明
- 当请求参数 oauth_callback=oob 则表明为桌面应用,会提示用户做桌面应用操作.
- oauth_callback=json, 页面直接返回参数
{"oauth_token":"c248561721393a78260b8d00ece7d703", "oauth_verifier":"234256"}
- oauth_callback=xml, 页面直接返回参数
<oauth_token>c248561721393a78260b8d00ece7d703</oauth_token> <oauth_verifier>234256</oauth_verifier>
oauth_token=8ldIZyxQeVrFZXFOZH5tAwj6vzJYuLQpl0WUEYtWc&oauth_verifier=pDNg57prOHapMbhv25RNf75lVRd6JDsni1AJJIDYoTY
这一步,我们需要获取oauth_token ,oauth_verifier。
获取access token(授权过的Oauth_token)
oauth_consumer_key - GDdmIQH6jhtmLUypg82g 创建应用时生成的APP KEY。
oauth_nonce - 9zWH6qe0qG7Lc1telCn7FhUbLyVdjEaL3MO5uHxn8 单次值,一个随机字符串 oauth_signature_method - HMAC-SHA1 签名方法
oauth_token - 8ldIZyxQeVrFZXFOZH5tAwj6vzJYuLQpl0WUEYtWc 经过用户授权的Request Token。
oauth_timestamp - 1272323047 时间戳
oauth_verifier - pDNg57prOHapMbhv25RNf75lVRd6JDsni1AJJIDYoTY 可选。在oauth/authorize这一步中,新浪微博给出的认证码。
oauth_version - 1.0 Oauth版本号
oauth_token_secret - x6qpRnlEmW9JbQn4PQVVeVG8ZLPEx6A0TOebgwcuA
参数说明:
- oauth_consumer_key: 创建应用时生成的APP KEY。
- oauth_token:经过用户授权的Request Token。
- oauth_signature_method: 签名方法,建议使用“HMAC-SHA1”。
- oauth_timestamp:时间戳。生成Base String时的时间戳。
- oauth_nonce:单次值,一个随机字符串,防止重复攻击。该参数只支持ASCII码的字符串.
- oauth_version : OAuth协议版本。填写“1.0”。
- oauth_verifier: 可选。在oauth/authorize这一步中,新浪微博给出的认证码。
- oauth_signature:签名值,是由根据上面的几个参数生成的 Base String经HMAC-SHA1算法计算得出。
POST&https://api.t.sina.com.cn/oauth/access_token&oauth_consumer_key=GDdmIQH6jhtmLUypg82g&oauth_nonce=9zWH6qe0qG7Lc1telCn7FhUbLyVdjEaL3MO5uHxn8&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1272323047&oauth_token=8ldIZyxQeVrFZXFOZH5tAwj6vzJYuLQpl0WUEYtWc&oauth_verifier=pDNg57prOHapMbhv25RNf75lVRd6JDsni1AJJIDYoTY&oauth_version=1.0
MCD8BKwGdgPHvAuvgvz4EQpqDAtx89grbuNMRd7Eh98&x6qpRnlEmW9JbQn4PQVVeVG8ZLPEx6A0TOebgwcuA
PUw/dHA4fnlJYM6RhXk5IU/0fCc=
OAuth oauth_nonce="9zWH6qe0qG7Lc1telCn7FhUbLyVdjEaL3MO5uHxn8",
oauth_signature_method="HMAC-SHA1",
oauth_timestamp="1272323047",
oauth_consumer_key="GDdmIQH6jhtmLUypg82g", oauth_token="8ldIZyxQeVrFZXFOZH5tAwj6vzJYuLQpl0WUEYtWc", oauth_verifier="pDNg57prOHapMbhv25RNf75lVRd6JDsni1AJJIDYoTY", oauth_signature="PUw/dHA4fnlJYM6RhXk5IU/0fCc=",
oauth_version="1.0"
oauth_token=819797-Jxq8aYUDRmykzVKrgoLhXSq67TEa5ruc4GJC2rWimw&oauth_token_secret=J6zix3FfA9LofH0awS24M3HcBYXO5nI1iYe8EfBA&
user_id=819797&
screen_name=openapi
获取用户信息
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | true | string | 申请应用时分配的AppKey,调用接口时候代表应用的唯一身份。(采用OAuth授权方式不需要此参数) |
:id | false | int64/string | 用户ID(int64)或者暱称(string)。该参数为一个REST风格参数。调用示例见注意事项 |
user_id | false | int64 | 用户ID,主要是用来区分用户ID跟微博暱称。当微博暱称为数字导致和用户ID产生歧义,特别是当微博暱称和用户ID一样的时候,建议使用该参数 |
screen_name | false | string | 微博暱称,主要是用来区分用户UID跟微博暱称,当二者一样而产生歧义的时候,建议使用该参数 |
:id、user_id、screen_name这三个参数三者至少要提供一个 |
oauth_consumer_key - GDdmIQH6jhtmLUypg82g
oauth_nonce - oElnnMTQIZvqvlfXM56aBLAf5noGD0AQR3Fmi7Q6Y
oauth_signature_method - HMAC-SHA1
oauth_token - 819797-Jxq8aYUDRmykzVKrgoLhXSq67TEa5ruc4GJC2rWimw
oauth_timestamp - 1272325550
oauth_version - 1.0
POST&http://api.t.sina.com.cn/account/verify_credentials&oauth_consumer_key=GDdmIQH6jhtmLUypg82g&oauth_nonce=9zWH6qe0qG7Lc1telCn7FhUbLyVdjEaL3MO5uHxn8&oauth_signature_method=HMAC-SHA1&oauth_timestamp=1272325550&oauth_token=819797-Jxq8aYUDRmykzVKrgoLhXSq67TEa5ruc4GJC2rWimw&oauth_verifier=pDNg57prOHapMbhv25RNf75lVRd6JDsni1AJJIDYoTY&oauth_version=1.0
MCD8BKwGdgPHvAuvgvz4EQpqDAtx89grbuNMRd7Eh98&J6zix3FfA9LofH0awS24M3HcBYXO5nI1iYe8EfBA
ICuKVLKetCO4axEppJBqOofFg/A=
OAuth oauth_nonce="oElnnMTQIZvqvlfXM56aBLAf5noGD0AQR3Fmi7Q6Y",
oauth_signature_method="HMAC-SHA1",
oauth_timestamp="1272325550",
oauth_consumer_key="GDdmIQH6jhtmLUypg82g",
oauth_token="819797-Jxq8aYUDRmykzVKrgoLhXSq67TEa5ruc4GJC2rWimw", oauth_signature="ICuKVLKetCO4axEppJBqOofFg/A=",
oauth_version="1.0"
{ weibo=null,
id=1803876591,
name='loopa',
screenName='loopa',
location='北京 海淀区',
description='2fBAcRG0]8OGRvp',
profileImageUrl='http://tp4.sinaimg.cn/1803876591/50/0',
url='',
isProtected=false,
followersCount=23,
statusCreatedAt=Mon Sep 27 13:50:14 CST 2010,
statusId=2847344825, statusText='uhYFQJ[',
statusSource='<a href="" rel="nofollow">微博开放平台接口</a>',
statusTruncated=false,
statusInReplyToStatusId=0,
statusInReplyToUserId=0,
statusFavorited=false,
statusInReplyToScreenName='',
profileBackgroundColor='',
profileTextColor='',
profileLinkColor='',
profileSidebarFillColor='',
profileSidebarBorderColor='',
friendsCount=1,
createdAt=Fri Aug 27 00:00:00 CST 2010,
favouritesCount=0,
utcOffset=-1,
timeZone='',
profileBackgroundImageUrl='',
profileBackgroundTile='',
following=false,
notificationEnabled=false,
statusesCount=8509,
geoEnabled=false,
verified=false }