XAuth

跳转到: 导航, 搜索

目录

关于xAuth

xAuth认证实际上是OAuth认证的简化版。目前xAuth只对桌面客户端和移动客户端开放申请。Web应用请使用OAuth。


xAuth申请需求

因为xAuth依然会获得用户明文密码,xAuth实行有限开放。开发初期建议使用桌面客户端使用OAuth,移动客户端使用WAP 1.0或者2.0版页面授权。当用户数量达到一定规模后再使用xAuth提升用户体验。
xAuth申请条件:

  1. 应用分类属于桌面客户端、手机客户端。
  2. 应用本身已经通过开放平台文案、广场审核,并在广场上展示超过15天。
  3. 应用使用人数在3000以上。
  4. 应用本身功能与微博关联紧密。


xAuth申请需提交材料:
企业

  1. 营业执照副本复印件
  2. 法人身份证复印件
  3. 税务登记副本复印件
  4. 应用产品说明文档:包括产品介绍、运营推广策略、改进目标等


个人

  1. 开发者身份证复印件
  2. 应用产品说明文档:包括产品介绍、运营推广策略、改进目标等

xAuth申请通过后,需签订合作开发者协议

请将上述资料和AppKey、应用名称一起发送邮件到weibo_app@vip.sina.com来申请xAuth的使用权。

xAuth简介

使用xAuth认证方式,您仍然需要了解如何生成OAuth签名。

为了方便桌面应用和移动应用,特别是那些缺乏浏览器支持的应用,xAuth认证为这类应用提供了一种使用用户名和密码来获取OAuth的Access Token的方式。 采用xAuth认证的桌面应用和移动应用可以跳过oauth/request_token(获取Request Token)以及oauth/authorize(授权Request Token)两步,只要提供了username和password以后,即可直接通过oauth/access_token接口得到Access Token。

使用xAuth

要使用xAuth认证,需要经过以下步骤:

1. 申请xAuth认证使用资格:将您的应用名称、APPKEY、为何要使用xAuth认证方式等详细信息发给weibo_app@vip.sina.com来申请xAuth的使用权。如果您已经获得xAuth使用权,请直接看第2步。

2. 获得xAuth的使用权后,为了能够生成OAuth签名,我们首先参考如何生成OAuth签名,生成OAuth的BaseString。注意,生成BaseString时需要传入如下几个参数:

   * x_auth_username:用户名(即用户在新浪通行证中使用的邮箱。)
   * x_auth_password:密码
   * x_auth_mode:标识字段,这里必须是"client_auth"。
   * oauth_consumer_key: 创建应用时生成的APP KEY。
   * oauth_signature_method: 签名方法,建议使用“HMAC-SHA1”。
   * oauth_timestamp:时间戳。生成Base String时的时间戳。
   * oauth_nonce:单次值,一个随机字符串,防止重复攻击。
   * oauth_version : OAuth协议版本。填写“1.0”。


生成的BaseString示例如下:

POST&http%3A%2F%2Fapi.t.sina.com.cn%2Foauth%2Faccess_token&oauth_consumer_key%3D1852823608%26oauth_nonce%3D-794036333%26oauth_signature_method%3DHMAC-SHA1%26oauth_timestamp%3D1291944694%26oauth_version%3D1.0%26source%3D1852823608%26x_auth_mode%3Dclient_auth%26x_auth_password%3D------%26x_auth_username%3D---------%2540sina.cn


3. 用刚刚生成的BaseString,经过HMAC-SHA1算法生成oauth_signature,示例如下:

iviIHhwXWmFLliZbeDoSyQ+XC1o=


4. 将以下参数封装成HTTP请求头,并向oauth/access_token接口提交POST请求:

  • x_auth_username,
  • x_auth_password,
  • x_auth_mode,
  • oauth_consumer_key,
  • oauth_signature_method,
  • oauth_signature,
  • oauth_timestamp,
  • oauth_nonce,
  • oauth_version,
  • source


Authorization: OAuth oauth_consumer_key="1852823608",oauth_signature_method="HMAC-SHA1",oauth_timestamp="1291944694",oauth_nonce="-794036333",oauth_version="1.0",oauth_signature="iviIHhwXWmFLliZbeDoSyQ%2BXC1o%3D",source="1852823608",x_auth_mode="client_auth",x_auth_password="------",x_auth_username="---------@sina.cn"


5. 得到的返回结果示例如下:

oauth_token=160e537d530fd105669fd79a4f1dc286&oauth_token_secret=a9c46c081842bd08f55e8f0265d8fea3&user_id=160984721


将返回结果按"&"拆开,oauth_token的值即为access_token。


oauth/access_token

第三放应用使用开始的request_token来换取用户授权过的Access_token。在xAuth认证方式中,也可以直接获取Access Token

URL

http://api.t.sina.com.cn/oauth/access_token

格式

标准的OAuth http返回格式

HTTP请求方式

POST

请求数限制

false

请求参数

  • 参考OAuth的第6章
  • x_auth_username:用户名(即用户在新浪通行证中使用的邮箱。),xAuth方式必填。
  • x_auth_password:密码,xAuth方式必填。
  • x_auth_mode:标识字段,这里必须是"client_auth",xAuth方式必填。
  • 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算法计算得出。

使用说明

返回值

oauth_token=c849d68edfd4d01dbb60c73e60c04360&oauth_token_secret=c7966260e5384f535222aa7aec7002c2&user_id=1567751400 

使用示例


PHP示例

请从 微博SDK开发包下载 处下载PHP SDK(支持OAuth验证之版本)
代码示例如下:

//oauth/access_token
$o = new WeiboOAuth( WB_AKEY , 
                     WB_SKEY , 
                     $_SESSION['keys']['oauth_token'] , 
                     $_SESSION['keys']['oauth_token_secret']  );

$last_key = $o->getAccessToken(  $_REQUEST['oauth_verifier'] ) ;
echo($last_key['oauth_token']);
文档更新时间: 2014-03-27