Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
My_csdo
JustAuth
提交
26884f72
J
JustAuth
项目概览
My_csdo
/
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看板
提交
26884f72
编写于
6月 28, 2020
作者:
智布道
👁
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
📝
添加 Facebook 授权登录的文档
上级
7f9c12d5
变更
8
隐藏空白更改
内联
并排
Showing
8 changed file
with
174 addition
and
2 deletion
+174
-2
docs/_sidebar.md
docs/_sidebar.md
+2
-2
docs/oauth/doc/media/oauth/065ebc6b.png
docs/oauth/doc/media/oauth/065ebc6b.png
+0
-0
docs/oauth/doc/media/oauth/0df639e4.png
docs/oauth/doc/media/oauth/0df639e4.png
+0
-0
docs/oauth/doc/media/oauth/658dcf45.png
docs/oauth/doc/media/oauth/658dcf45.png
+0
-0
docs/oauth/doc/media/oauth/a2efba1a.png
docs/oauth/doc/media/oauth/a2efba1a.png
+0
-0
docs/oauth/doc/media/oauth/f3d0395a.png
docs/oauth/doc/media/oauth/f3d0395a.png
+0
-0
docs/oauth/doc/media/oauth/f5bf4cd3.png
docs/oauth/doc/media/oauth/f5bf4cd3.png
+0
-0
docs/oauth/facebook.md
docs/oauth/facebook.md
+172
-0
未找到文件。
docs/_sidebar.md
浏览文件 @
26884f72
...
@@ -22,8 +22,8 @@
...
@@ -22,8 +22,8 @@
-
[
√ 钉钉登录
](
oauth/dingtalk.md
)
-
[
√ 钉钉登录
](
oauth/dingtalk.md
)
-
[
√ 开源中国登录
](
oauth/oschina.md
)
-
[
√ 开源中国登录
](
oauth/oschina.md
)
-
[
淘宝登录
](
oauth/taobao.md
)
-
[
淘宝登录
](
oauth/taobao.md
)
-
[
Google登录
](
oauth/google.md
)
-
[
√
Google登录
](
oauth/google.md
)
-
[
Facebook登录
](
oauth/facebook.md
)
-
[
√
Facebook登录
](
oauth/facebook.md
)
-
[
抖音登录
](
oauth/douyin.md
)
-
[
抖音登录
](
oauth/douyin.md
)
-
[
√ 领英登录
](
oauth/linkedin.md
)
-
[
√ 领英登录
](
oauth/linkedin.md
)
-
[
微软登录
](
oauth/microsoft.md
)
-
[
微软登录
](
oauth/microsoft.md
)
...
...
docs/oauth/doc/media/oauth/065ebc6b.png
0 → 100644
浏览文件 @
26884f72
23.2 KB
docs/oauth/doc/media/oauth/0df639e4.png
0 → 100644
浏览文件 @
26884f72
18.6 KB
docs/oauth/doc/media/oauth/658dcf45.png
0 → 100644
浏览文件 @
26884f72
96.4 KB
docs/oauth/doc/media/oauth/a2efba1a.png
0 → 100644
浏览文件 @
26884f72
75.9 KB
docs/oauth/doc/media/oauth/f3d0395a.png
0 → 100644
浏览文件 @
26884f72
86.5 KB
docs/oauth/doc/media/oauth/f5bf4cd3.png
0 → 100644
浏览文件 @
26884f72
73.4 KB
docs/oauth/facebook.md
0 → 100644
浏览文件 @
26884f72
## 1. 申请应用
### 1.1 创建第三方授权应用
1.
登录 Facebook 开发者中心:
[
Facebook 开发者中心
](
https://developers.facebook.com/
)
2.
进入“我的应用”管理页面
3.
点击“添加新应用”,在弹窗中选择“用于其他用途”
![](
doc/media/oauth/f5bf4cd3.png
)
4.
按照提示,创建应用编号
![](
doc/media/oauth/065ebc6b.png
)
5.
在应用详情页面,选择“Facebook 登录”
![](
doc/media/oauth/658dcf45.png
)
6.
配置“Facebook 登录”的回调地址
![](
doc/media/oauth/f3d0395a.png
)
7.
获取
`Client ID`
和
`Client Secret`
点击左侧菜单“设置 - 基本”即可看到认证密钥
![](
doc/media/oauth/a2efba1a.png
)
记录以下三个信息:
`Client ID`
、
`Client Secret`
和
`回调地址`
,后面我们会用到。
**重要提示:“应用密钥”可保护你应用程序的安全,因此请确保其不会泄露!也不要与任何人共享你的“应用密钥”!!!**
## 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
AuthFacebookRequest
(
AuthConfig
.
builder
()
.
clientId
(
"Client ID"
)
.
clientSecret
(
"Client Secret"
)
.
redirectUri
(
"应用回调地址"
)
// 针对国外平台配置代理
.
httpConfig
(
HttpConfig
.
builder
()
.
timeout
(
15000
)
// host 和 port 请修改为开发环境的参数
.
proxy
(
new
Proxy
(
Proxy
.
Type
.
HTTP
,
new
InetSocketAddress
(
"127.0.0.1"
,
10080
)))
.
build
())
.
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.AuthFacebookRequest
;
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
;
import
java.net.InetSocketAddress
;
import
java.net.Proxy
;
@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
AuthFacebookRequest
(
AuthConfig
.
builder
()
.
clientId
(
"Client ID"
)
.
clientSecret
(
"Client Secret"
)
.
redirectUri
(
"回调地址"
)
// 针对国外平台配置代理
.
httpConfig
(
HttpConfig
.
builder
()
.
timeout
(
15000
)
// host 和 port 请修改为开发环境的参数
.
proxy
(
new
Proxy
(
Proxy
.
Type
.
HTTP
,
new
InetSocketAddress
(
"127.0.0.1"
,
10080
)))
.
build
())
.
build
());
}
}
```
授权链接访问成功后会看到以下页面内容:
![](
doc/media/oauth/0df639e4.png
)
点击“连接”即可完成百度的 OAuth 登录。
## 3. 授权结果
注:数据已脱敏
```
json
{
"code"
:
2000
,
"data"
:{
"avatar"
:
"https://platform-lookaside.fbsbx.com/platform/profilepic/?asid=27692792&width=400&ext=1595947235&hash=AeS4-5s-I7w4xQq6"
,
"gender"
:
"UNKNOWN"
,
"nickname"
:
"张亚东"
,
"rawUserInfo"
:{
"name"
:
"张亚东"
,
"id"
:
"27692792"
,
"picture"
:{
"data"
:{
"is_silhouette"
:
false
,
"width"
:
480
,
"url"
:
"https://platform-lookaside.fbsbx.com/platform/profilepic/?asid=27692792&width=400&ext=1595947235&hash=AeS4-5s-I7w4xQq6"
,
"height"
:
480
}
}
},
"source"
:
"FACEBOOK"
,
"token"
:{
"accessToken"
:
""
,
"expireIn"
:
5183884
,
"tokenType"
:
"bearer"
},
"username"
:
"张亚东"
,
"uuid"
:
"27692792"
}
}
```
## 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 项目进行测试,那么在配置测试应用的“回调地址”时要严格按照以下格式配置:
`http://localhost:8443/oauth/callback/{平台名}`
2.
平台名参考
`JustAuthPlatformInfo`
枚举类
`names`
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录