SpringBoot+Vue实现第三方百度登录(二)
1 准备工作
本步骤的作用:
接入百度登录前,网站需首先进行申请,获得对应的appid与appkey,以保证后续流程中可正确对网站与用户进行验证与授权。
1.1 保存appid和appkey
appid:应用的唯一标识。在OAuth2.0认证过程中,appid的值即为oauth_consumer_key的值。
appkey:appid对应的密钥,访问用户资源时用来验证应用的合法性。在OAuth2.0认证过程中,appkey的值即为oauth_consumer_secret的值。
1.2 官方开发文档
百度API文档说明
百度API文档说明
2 放置“百度登录”按钮
本步骤的作用:
在网站页面上放置“百度登录”按钮,并为按钮添加前台代码,实现点击按钮即弹出百度登录对话框 。
2.1 下载“百度登录”按钮图片,并将按钮放置在页面合适的位置
可以到阿里矢量图库下载更多图标:阿里巴巴矢量图标库 。
2.2 为“百度登录”按钮添加前台代码
2.2.1 效果演示
2.2.2 前端代码(Vue)
为了实现上述效果,应该为“百度登录”按钮图片添加如下前台代码:
第三方登录:
// 百度登录
handleBaiDuLogin() {
this.dialogVisible = true;
this.pictureType = 'BaiDuLogin'
},
2.2.3 后端代码(Java)
百度登录配置文件信息:
# 百度登录配置
baidu.appID = 6666666(替换成你的)
baidu.appKEY = 666666666666666666(替换成你的)
baidu.redirectURI = https://www.youyoushop.work/baiDuCallback(替换成你的)
baidu.authorizeURL = https://openapi.baidu.com/oauth/2.0/authorize
baidu.accessToken = https://openapi.baidu.com/oauth/2.0/token
baidu.loggedInUser = https://openapi.baidu.com/rest/2.0/passport/users/getLoggedInUser
baidu.userInfo = https://openapi.baidu.com/rest/2.0/passport/users/getInfo
baidu.userFriends = https://openapi.baidu.com/rest/2.0/friends/getFriends
baidu.expireSession = https://openapi.baidu.com/rest/2.0/passport/auth/expireSession
baidu.revokeAuthorization = https://openapi.baidu.com/rest/2.0/passport/auth/revokeAuthorization
baidu.image = http://tb.himg.baidu.com/sys/portraitn/item/
baidu.largeImage = http://tb.himg.baidu.com/sys/portrait/item/
读取配置文件信息常量类:
package com.liyh.modules.security.constants;
import lombok.Data;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.PropertySource;
/**
* 百度登陆常量配置类
* @author Liyh
* @date 2020/12/22
*/
@Data
@Configuration
@PropertySource("classpath:thirdparty/config.properties") // 指定配置文件的路径,属性文件需放在根目录的resources文件夹下面,才能被读取出来
public class BaiDuConstants {
@Value("${baidu.appID}")
private String appID;
@Value("${baidu.appKEY}")
private String appKEY;
@Value("${baidu.redirectURI}")
private String redirectURI;
@Value("${baidu.authorizeURL}")
private String authorizeURL;
@Value("${baidu.accessToken}")
private String accessToken;
@Value("${baidu.loggedInUser}")
private String loggedInUser;
@Value("${baidu.userInfo}")
private String userInfo;
@Value("${baidu.userFriends}")
private String userFriends;
@Value("${baidu.expireSession}")
private String expireSession;
@Value("${baidu.revokeAuthorization}")
private String revokeAuthorization;
@Value("${baidu.image}")
private String image;
@Value("${baidu.largeImage}")
private String largeImage;
}
Conteoller(获取微博登录的url)
/**
* 获得跳转到百度登录页的url,前台直接a连接访问
*
* @return
* @throws Exception
*/
@ApiOperation("获得跳转到百度登录页的url")
@GetMapping("/getBaiDuCode")
public ResponseEntity
3 获取授权过的Access Token
3.1 简介
redirect_uri指定的开发者服务器地址,在获取到授权code参数后,从服务端向百度开放平台发起如下HTTP请求,通过code换取网页授权access_token。
注意:access_token长度保留256字符。
3.2 请求用户授权,获取Authorization Code
请求地址:
https://openapi.baidu.com/oauth/2.0/authorize
请求参数:
必选 | 类型及范围 | 说明 | |
---|---|---|---|
client_id | true | string | 申请应用时分配的AppKey。 |
redirect_uri | true | string | 授权回调地址,站外应用需与设置的回调地址一致,站内应用需填写canvas page的地址。 |
response_type | true | string | 必须参数,此值固定为“code” |
scope | false | string | 申请scope权限所需参数,可一次申请多个scope权限,用逗号分隔。 |
state | false | string | 用于保持请求和回调的状态,在回调时,会在Query Parameter中回传该参数。开发者可以用这个参数验证请求有效性,也可以记录用户请求授权页前的位置。这个参数可用于防止跨站请求伪造(CSRF)攻击 |
display | false | string | 授权页面的终端类型,取值见下面的说明。 |
返回数据:
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
code | string | 用于第二步调用oauth2/access_token接口,获取授权后的access token。 |
state | string | 如果传递参数,会回传该参数。 |
返回示例:
// 请求地址
https://openapi.baidu.com/oauth/2.0/authorize? response_type=code& client_id=Va5yQRHlA4Fq4eR3LT0vuXV4& redirect_uri=http%3A%2F%2Fwww.example.com%2Foauth_redirect& scope=email& display=popup
注意事项:
每一个Authorization Code的有效期为10分钟,并且只能使用一次,再次使用将无效。
3.3 通过Authorization Code获取Access Token
请求地址:
https://openapi.baidu.com/oauth/2.0/token
请求方法:
POST
请求参数:
参数名 | 类型 | 是否必须 | 描述 |
---|---|---|---|
grant_type | string | 是 | 固定为authorization_code |
code | string | 是 | 用户授权后得到code |
client_id | string | 是 | 应用的API Key |
client_secret | string | 是 | 应用的Secret Key |
redirect_uri | string | 是 | 该值必须与获取Authorization Code时传递的“redirect_uri”保持一致。 |
返回说明:
返回值字段 | 字段类型 | 字段说明 |
---|---|---|
access_token | string | 获取到的网页授权接口调用凭证 |
expires_in | int | access_token的生命周期,单位是秒数。 |
refresh_token | string | 用于刷新Access Token的Refresh Token,所有应用都会返回该参数**(10年的有效期**) |
scope | string | Access Token最终的访问范围,即用户实际授予的权限列表(用户在授权页面时,有可能会取消掉某些请求的权限) |
session_key | string | 基于http调用Open API时所需要的Session Key,其有效期与Access Token一致 |
session_secret | string | 基于http调用Open API时计算参数签名用的签名密钥 |
{
"access_token": "1.a6b7dbd428f731035f771b8d15063f61.86400.1292922000-2346678-124328",
"expires_in": 86400,
"refresh_token": "2.385d55f8615fdfd9edb7c4b5ebdc3e39.604800.1293440400-2346678-124328",
"scope": "basic email",
"session_key": "ANXxSNjwQDugf8615OnqeikRMu2bKaXCdlLxn",
"session_secret": "248APxvxjCZ0VEC43EYrvxqaK4oZExMB"
}
接口代码:
/** * 获得token信息(授权,每个用户的都不一致) --> 获得token信息该步骤返回的token期限为一个月 * * @return * @throws Exception */
public MapgetToken(String code) throws Exception {
MapbaiDuProperties = new HashMap ();
try {
// https://openapi.baidu.com/oauth/2.0/token?
// grant_type=authorization_code&
// code=ANXxSNsdffff2bKaXCdlLxn&
// client_id=Va5yQRHlasdfasdfLT0vuXV4&
// client_secret=0rDSjzQ2asdfasdfPQSzr5pVw2&
// redirect_uri=http%3A%2F%2Fwww.example.com%2Foauth_redirect
StringBuilder url = new StringBuilder();
url.append(baiDuConstants.getAccessToken());
url.append("?client_id=" + baiDuConstants.getAppID());
url.append("&client_secret=" + baiDuConstants.getAppKEY());
url.append("&grant_type=authorization_code");
// 回调地址
String redirectUri = baiDuConstants.getRedirectURI();
// 转码
url.append("&redirect_uri=" + URLEncodeUtil.getURLEncoderString(redirectUri));
url.append("&code=" + code);
// 获得token
String result = HttpUtil.post(url.toString(), "UTF-8");
// {
// "access_token": "1.a6b7db323432422000-2346678-124328",
// "expires_in": 86400,
// "refresh_token": "2.385234234400-2346678-124328",
// "scope": "basic email",
// "session_key": "ANXxSN234234aXCdlLxn",
// "session_secret": "248APxv23432444oZExMB",
// }
// 把token保存
JSONObject object = JSONObject.fromObject(result);
//token信息
baiDuProperties = new HashMap();
baiDuProperties.put("accessToken", object.getString("access_token"));
} catch (Exception e) {
throw new BadRequestException("百度登录信息异常,请重试!!!");
}
return baiDuProperties;
}
4 获取授权用户信息
本步骤的作用:
获取access_token之后,开发者可以通过access_token拉取用户信息。
请求地址:
https://openapi.baidu.com/rest/2.0/passport/users/getInfo
请求方法:
POST
请求参数:
必选 | 类型及范围 | 说明 | |
---|---|---|---|
access_token | 是 | string | 采用OAuth授权方式为必填参数,OAuth授权后获得。 |
get_unionid | 否 | int | 需要获取unionid时,传递get_unionid = 1 |
返回参数:
参数名 | 参数类型 | 是否必需 | 示例值 | 描述 |
---|---|---|---|---|
openid | string | 是 | oPXyY4O0ZTmUqSX4MRxYDDCccT6Kc9E | 百度用户的唯一标识,对当前开发者帐号、当前应用唯一 |
unionid | string | 否 | uA91qQ6gAISTuy0mMqoeh7lZ0w6x478 | 百度用户统一标识,对当前开发者帐号唯一 |
userid | uint | 否 | 67411167 | 老版 百度用户的唯一标识,后续不在返回该字段 |
securemobile | uint | 否 | 188888888 | 当前用户绑定手机号(需要向开放平台申请权限) |
username | string | 否 | t***e | 当前登录用户的展示用户名,包含打码"*"号 |
portrait | string | 否 | e2c1776c31393837313031319605 | 当前登录用户的头像,头像地址拼接使用方法:https://himg.bdimg.com/sys/portrait/item/{$portrait} |
userdetail | string | 否 | 喜欢自由 | 自我简介,可能为空。 |
birthday | string | 否 | 1987-01-010000-00-00为未知 | 生日,以yyyy-mm-dd格式显示。 |
marriage | string | 否 | 0:未知,1:单身,2:已婚3:恋爱4:离异 | 婚姻状况 |
sex | string | 否 | 0:未知,1:男,2:女 | 性别 |
blood | string | 否 | 0:未知,1:A,2:B,3:O,4:AB,5:其他 | 血型 |
is_bind_mobile | uint | 否 | 0:未绑定,1:已绑定 | 是否绑定手机号 |
is_realname | uint | 否 | 0:未实名制,1:已实名制 | 是否实名制 |
接口代码:
/** * accessToken,uid 获取用户信息 */
public String getUserJson(MapbaiDuProperties) throws Exception {
String result = null;
try {
// https://openapi.baidu.com/rest/2.0/passport/users/getInfo?access_token=xxx&
// 取出token
String accessToken = (String) baiDuProperties.get("accessToken");
if (StringUtils.isEmpty(accessToken)) {
throw new BadRequestException("百度登录信息异常,请重试!!!");
}
// 拼接url
StringBuilder url = new StringBuilder();
url.append(baiDuConstants.getUserInfo());
url.append("?access_token=" + accessToken);
// 获取百度用户信息相关数据
result = HttpUtil.post(url.toString(), "UTF-8");
} catch (Exception e) {
throw new BadRequestException("百度登录信息异常,请重试!!!");
}
return result;
}