Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
kuyz
JustAuth
提交
cf6f42b5
J
JustAuth
项目概览
kuyz
/
JustAuth
与 Fork 源项目一致
Fork自
justauth / JustAuth
通知
1
Star
0
Fork
0
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
DevOps
流水线
流水线任务
计划
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
J
JustAuth
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
DevOps
DevOps
流水线
流水线任务
计划
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
流水线任务
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
cf6f42b5
编写于
6月 28, 2020
作者:
智布道
👁
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
📝
增加 baidu 授权登录的文档
上级
6f313fa9
变更
1
隐藏空白更改
内联
并排
Showing
1 changed file
with
155 addition
and
0 deletion
+155
-0
docs/oauth/baidu.md
docs/oauth/baidu.md
+155
-0
未找到文件。
docs/oauth/baidu.md
0 → 100644
浏览文件 @
cf6f42b5
## 1. 申请应用
### 1.1 登录百度开发者中心
1.
注册百度开发者账号:
[
百度Passport
](
https://passport.baidu.com/v2/?reg&u=http%3A%2F%2Fdeveloper.baidu.com%2F&tpl=dev
)
。如果已有则忽略该步骤,直接进入第二步。
2.
登录百度开发者中心:
[
百度开发者中心
](
http://developer.baidu.com/
)
### 1.2 创建第三方授权应用
1.
进入百度开发者控制台应用管理页面:
[
应用管理
](
http://developer.baidu.com/console#app/project
)
2.
单击“创建工程”,开始创建应用。
![](
doc/media/oauth/b43448b8.png
)
![](
doc/media/oauth/9d2676f1.png
)
记录以下三个信息:
`API Key`
、
`Secret Key`
和
`应用回调地址`
,后面我们会用到。
注:
`API Key`
、
`Secret Key`
在“基本信息”页面
![](
doc/media/oauth/37c56184.png
)
## 2. 集成JustAuth
### 2.1 引入依赖
```
xml
<dependency>
<groupId>
me.zhyd.oauth
</groupId>
<artifactId>
JustAuth
</artifactId>
<version>
${latest.version}
</version>
</dependency>
```
`${latest.version}`
表示当前最新的版本,可以在
[
这儿
](
https://github.com/justauth/JustAuth/releases
)
获取最新的版本信息。
### 2.2 创建Request
```
java
AuthRequest
authRequest
=
new
AuthBaiduRequest
(
AuthConfig
.
builder
()
.
clientId
(
"Client ID"
)
.
clientSecret
(
"Client Secret"
)
.
redirectUri
(
"应用回调地址"
)
.
build
());
```
### 2.3 生成授权地址
我们可以直接使用以下方式生成第三方平台的授权链接:
```
java
String
authorizeUrl
=
authRequest
.
authorize
(
AuthStateUtils
.
createState
());
```
这个链接我们可以直接后台重定向跳转,也可以返回到前端后,前端控制跳转。前端控制的好处就是,可以将第三方的授权页嵌入到iframe中,适配网站设计。
### 2.4 以上完整代码如下
```
java
import
me.zhyd.oauth.config.AuthConfig
;
import
me.zhyd.oauth.request.AuthBaiduRequest
;
import
me.zhyd.oauth.model.AuthCallback
;
import
me.zhyd.oauth.request.AuthRequest
;
import
me.zhyd.oauth.utils.AuthStateUtils
;
import
org.springframework.web.bind.annotation.PathVariable
;
import
org.springframework.web.bind.annotation.RequestMapping
;
import
org.springframework.web.bind.annotation.RestController
;
import
javax.servlet.http.HttpServletResponse
;
import
java.io.IOException
;
@RestController
@RequestMapping
(
"/oauth"
)
public
class
RestAuthController
{
@RequestMapping
(
"/render"
)
public
void
renderAuth
(
HttpServletResponse
response
)
throws
IOException
{
AuthRequest
authRequest
=
getAuthRequest
();
response
.
sendRedirect
(
authRequest
.
authorize
(
AuthStateUtils
.
createState
()));
}
@RequestMapping
(
"/callback"
)
public
Object
login
(
AuthCallback
callback
)
{
AuthRequest
authRequest
=
getAuthRequest
();
return
authRequest
.
login
(
callback
);
}
private
AuthRequest
getAuthRequest
()
{
return
new
AuthBaiduRequest
(
AuthConfig
.
builder
()
.
clientId
(
"API Key"
)
.
clientSecret
(
"Secret Key"
)
.
redirectUri
(
"应用回调地址"
)
.
build
());
}
}
```
授权链接访问成功后会看到以下页面内容:
![](
doc/media/oauth/7097ddf0.png
)
点击“授权”即可完成百度的 OAuth 登录。
## 3. 授权结果
注:数据已脱敏
```
json
{
"code"
:
2000
,
"data"
:{
"avatar"
:
"http://himg.bdimg.com/sys/portrait/item/1ea2e5878cxxxe4b8bf4882.jpg"
,
"gender"
:
"MALE"
,
"nickname"
:
"凌***丿"
,
"rawUserInfo"
:{
"birthday"
:
"2009-04-05"
,
"openid"
:
"oD0ag_m52Xxxxxx6wWP2Dbm1X"
,
"sex"
:
"1"
,
"is_realname"
:
"1"
,
"portrait"
:
"1ea2e5878cxxx4b8bf4882"
,
"is_bind_mobile"
:
"1"
,
"blood"
:
"2"
,
"username"
:
"凌***丿"
},
"source"
:
"BAIDU"
,
"token"
:{
"accessToken"
:
"121.7f063a00b80xxxP8H6YxcJqD.C3r33w"
,
"expireIn"
:
2592000
,
"refreshToken"
:
"122.b8cff99fe00cbxxxxZt-xSF906TGkEmPvdEn.IUdj0g"
,
"scope"
:
"basic"
},
"username"
:
"凌***丿"
,
"uuid"
:
"oD0ag_m52xxxWP2Dbm1X"
}
}
```
## 3. 推荐
官方推荐使用
[
JustAuth-demo
](
https://github.com/justauth/JustAuth-demo
)
示例项目进行测试。
使用步骤:
1.
clone:
[
https://github.com/justauth/JustAuth-demo.git
](
https://github.com/justauth/JustAuth-demo.git
)
2.
将上面申请的应用信息填入到
`RestAuthController#getAuthRequest`
方法的对应位置中:
![](
doc/media/oauth/e1a40945.png
)
3.
启动项目,访问
[
http://localhost:8443
](
http://localhost:8443
)
4.
选择对应的平台进行授权登录
![](
doc/media/oauth/da2bc692.png
)
5.
登录完成后,可以访问
[
http://localhost:8443/users
](
http://localhost:8443/users
)
查看已授权的用户
![](
doc/media/oauth/dbe6bcae.png
)
注:
1.
JustAuth-demo 中的用户保存使用的本地 Map,所以重启项目后已登录的用户数据就会丢失
2.
如果直接使用 JustAuth-demo 项目进行测试,那么在配置测试应用的“回调地址”时要严格按照以下格式配置:
`http://localhost:8443/oauth/callback/{平台名}`
3.
平台名参考
`JustAuthPlatformInfo`
枚举类
`names`
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录