社会化登录接入
(→登录界面) |
(→登录界面) |
||
(未显示1个用户的21个中间版本) | |||
第4行: | 第4行: | ||
====登录界面==== | ====登录界面==== | ||
云登录接入引擎使用JavaScript脚本在你的网站上添加一个用户界面十分友好的登录框。下面是一个登录插件的样例。我们会通过JavaScript脚本帮助你实现登录框在你的网站上的样式自定义。 | 云登录接入引擎使用JavaScript脚本在你的网站上添加一个用户界面十分友好的登录框。下面是一个登录插件的样例。我们会通过JavaScript脚本帮助你实现登录框在你的网站上的样式自定义。 | ||
− | < | + | [[Image:登录界面.png|600px]]<br /> |
− | + | 除了使用JavaScript的脚本的弹出效果外,你还可以直接在你的网页界面上嵌入一个登录模块。 在云登录网上自主建造类型中的获取代码页中获取相应代码。 | |
+ | |||
+ | ===社会化登录接入流程=== | ||
+ | ====流程图==== | ||
+ | [[Image:流程图.png|600px]] | ||
+ | ====流程说明==== | ||
+ | #客户端通过登录界面按钮请求登录并传递在云登录注册的appid; | ||
+ | #登录成功,云登录服务器返回token给客户; | ||
+ | #客户通过token发送获取用户信息请求; | ||
+ | #云登录服务器验证token返回给客户用户信息。 | ||
+ | |||
+ | ===开发流程=== | ||
+ | ====请求登录==== | ||
+ | =====传递云登录app id===== | ||
+ | 如果使用云登录提供的登录框javascript代码,详细配置见http://www.ecopen.cn 的自定义插件样式页面。 | ||
+ | [[Image:自定义样式.png|600px]] | ||
+ | |||
+ | 获取javascript代码: | ||
+ | [[Image:获取JS代码.png|600px]] | ||
+ | |||
+ | =====返回token===== | ||
+ | 在开发登录功能时,开发者需要专门创建一个页面用来接收由云登录服务器发送的token,这个页面的地址即回调地址(token_url)。 | ||
+ | 创建好页面后,需要把这个token_url填写到云登录控制台http://www.ecopen.cn 的回调地址处。 | ||
+ | [[Image:填写回调地址.png|600px]] | ||
+ | |||
+ | 云登录服务器会以参数的形式返回token到你的token_url。 | ||
+ | |||
+ | 示例:http://www.ecopen.cn/token.php?token=XXXXXX | ||
+ | |||
+ | =====转发地址===== | ||
+ | 由于开心网、雅虎、Windows Live等社会化平台提供商要求其应用返回地址必须为注册其应用的域名下的地址。为了完成云登录作为中间键的接入解决方案,开发者需要专门创建一个中转页面 向云登录服务器进行转发(页面操作为把社会化提供商传来的参数重定向到http://www.ecopen.cn/receiver 页面),这个页面的地 址即转发地址(receiver_url)。 | ||
+ | 创建好页面后,需要把这个receiver_url填写到云登录控制台http://www.ecopen.cn 的转发地址处。 | ||
+ | [[Image:填写转发地址.png|600px]] | ||
+ | |||
+ | ====获取用户信息==== | ||
+ | =====调用denglu.user.get接口===== | ||
+ | |||
+ | 接口地址:http://www.ecopen.cn/api | ||
+ | 请求参数: | ||
+ | <div> | ||
+ | {|class="table" cellspacing="0" cellpadding="5" border="0" | ||
+ | |- style="background-color:#ffffcc;" | ||
+ | !参数 | ||
+ | !是否必填 | ||
+ | !描述 | ||
+ | |- | ||
+ | |method | ||
+ | |是 | ||
+ | |API接口名称 | ||
+ | |- | ||
+ | |appid | ||
+ | |是 | ||
+ | |你的云登入App ID | ||
+ | |- | ||
+ | |timestamp | ||
+ | |是 | ||
+ | |时间戳,允许客户端请求时间误差为10分钟 | ||
+ | |- | ||
+ | |sign_method | ||
+ | |是 | ||
+ | |签名的加密方式,只支持MD5 | ||
+ | |- | ||
+ | |v | ||
+ | |是 | ||
+ | |API协议版本,可选值:1.0。 | ||
+ | |- | ||
+ | |format | ||
+ | |否 | ||
+ | |可选,指定响应格式。默认json,目前支持格式为xml,json | ||
+ | |- | ||
+ | |token | ||
+ | |是 | ||
+ | |云登入GET到你token_url的token值 | ||
+ | |- | ||
+ | |sign | ||
+ | |是 | ||
+ | |API输入参数签名结果 | ||
+ | |} | ||
+ | </div> | ||
+ | |||
+ | =====接收用户信息===== | ||
+ | 成功返回信息: | ||
+ | <pre> | ||
+ | { | ||
+ | 'res' : 'succ', | ||
+ | 'data' : { | ||
+ | 'openid' : '1337333333', | ||
+ | 'provider_code' : 'qzone', | ||
+ | 'provider_openid' : 'A57CEB51BFA93E7AE958C9B1FA139134', | ||
+ | 'nickname' : 'Leo', | ||
+ | 'realname' : '云登录', | ||
+ | 'avatar' : 'http://qzapp.qlogo.cn/qzapp/100258164/A57CEB51BFA93E7AE958C9B1FA139134/30', | ||
+ | 'email' : '23148953@qq.com', | ||
+ | 'gender' : '1', | ||
+ | 'address' : '浦东新' | ||
+ | } | ||
+ | } | ||
+ | </pre> | ||
+ | |||
+ | denglu.user.get详细使用方法请查看API文档中的 [[获取用户信息|denglu.user.get接口]] |
2012年6月20日 (三) 18:26的最后版本
目录 |
社会化登录功能简介
概述
云登录可以帮助你很方便地为你的网站添加一组社会化媒体账号登录按钮。我们帮助你添加来自人人网、开心网、新浪微博、豆瓣、淘宝、Windows Live、Google等第三方账号提供商的授权认证功能,这将使你的网站轻松拥有庞大的用户基础,用户可以非常非常简单方便的直接登录你的网站。这个功 能运行在我们的服务器端,通过非常简单和轻量级的API调用完成。云登录接入引擎是一个介于你的网站和其他第三方社会化媒体平台提供商之间的代理平台; 但我们对你的终端用户是完全透明的。添加云登录接入引擎到你的网站并不需要对你的数据库做任何改动,只需要你的服务器同云登录服务器进行通讯并解析一些 JSON或者XML格式的结果数据。
登录界面
云登录接入引擎使用JavaScript脚本在你的网站上添加一个用户界面十分友好的登录框。下面是一个登录插件的样例。我们会通过JavaScript脚本帮助你实现登录框在你的网站上的样式自定义。
除了使用JavaScript的脚本的弹出效果外,你还可以直接在你的网页界面上嵌入一个登录模块。 在云登录网上自主建造类型中的获取代码页中获取相应代码。
社会化登录接入流程
流程图
流程说明
- 客户端通过登录界面按钮请求登录并传递在云登录注册的appid;
- 登录成功,云登录服务器返回token给客户;
- 客户通过token发送获取用户信息请求;
- 云登录服务器验证token返回给客户用户信息。
开发流程
请求登录
传递云登录app id
如果使用云登录提供的登录框javascript代码,详细配置见http://www.ecopen.cn 的自定义插件样式页面。
返回token
在开发登录功能时,开发者需要专门创建一个页面用来接收由云登录服务器发送的token,这个页面的地址即回调地址(token_url)。 创建好页面后,需要把这个token_url填写到云登录控制台http://www.ecopen.cn 的回调地址处。
云登录服务器会以参数的形式返回token到你的token_url。
示例:http://www.ecopen.cn/token.php?token=XXXXXX
转发地址
由于开心网、雅虎、Windows Live等社会化平台提供商要求其应用返回地址必须为注册其应用的域名下的地址。为了完成云登录作为中间键的接入解决方案,开发者需要专门创建一个中转页面 向云登录服务器进行转发(页面操作为把社会化提供商传来的参数重定向到http://www.ecopen.cn/receiver 页面),这个页面的地 址即转发地址(receiver_url)。 创建好页面后,需要把这个receiver_url填写到云登录控制台http://www.ecopen.cn 的转发地址处。
获取用户信息
调用denglu.user.get接口
接口地址:http://www.ecopen.cn/api 请求参数:
参数 | 是否必填 | 描述 |
---|---|---|
method | 是 | API接口名称 |
appid | 是 | 你的云登入App ID |
timestamp | 是 | 时间戳,允许客户端请求时间误差为10分钟 |
sign_method | 是 | 签名的加密方式,只支持MD5 |
v | 是 | API协议版本,可选值:1.0。 |
format | 否 | 可选,指定响应格式。默认json,目前支持格式为xml,json |
token | 是 | 云登入GET到你token_url的token值 |
sign | 是 | API输入参数签名结果 |
接收用户信息
成功返回信息:
{ 'res' : 'succ', 'data' : { 'openid' : '1337333333', 'provider_code' : 'qzone', 'provider_openid' : 'A57CEB51BFA93E7AE958C9B1FA139134', 'nickname' : 'Leo', 'realname' : '云登录', 'avatar' : 'http://qzapp.qlogo.cn/qzapp/100258164/A57CEB51BFA93E7AE958C9B1FA139134/30', 'email' : '23148953@qq.com', 'gender' : '1', 'address' : '浦东新' } }
denglu.user.get详细使用方法请查看API文档中的 denglu.user.get接口