Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
BI8CLL灬
JustAuth
提交
b564ce8a
J
JustAuth
项目概览
BI8CLL灬
/
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,发现更多精彩内容 >>
提交
b564ce8a
编写于
6月 28, 2020
作者:
智布道
👁
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
📝
增加 开源中国 授权登录的文档
上级
5e006550
变更
5
隐藏空白更改
内联
并排
Showing
5 changed file
with
154 addition
and
1 deletion
+154
-1
docs/_sidebar.md
docs/_sidebar.md
+1
-1
docs/oauth/doc/media/oauth/007acd70.png
docs/oauth/doc/media/oauth/007acd70.png
+0
-0
docs/oauth/doc/media/oauth/895f76da.png
docs/oauth/doc/media/oauth/895f76da.png
+0
-0
docs/oauth/doc/media/oauth/f403ad52.png
docs/oauth/doc/media/oauth/f403ad52.png
+0
-0
docs/oauth/oschina.md
docs/oauth/oschina.md
+153
-0
未找到文件。
docs/_sidebar.md
浏览文件 @
b564ce8a
...
...
@@ -20,7 +20,7 @@
-
[
微信公众平台登录
](
oauth/wechat_mp.md
)
-
[
√ 百度登录
](
oauth/baidu.md
)
-
[
√ 钉钉登录
](
oauth/dingtalk.md
)
-
[
开源中国登录
](
oauth/oschina.md
)
-
[
√
开源中国登录
](
oauth/oschina.md
)
-
[
淘宝登录
](
oauth/taobao.md
)
-
[
Google登录
](
oauth/google.md
)
-
[
Facebook登录
](
oauth/facebook.md
)
...
...
docs/oauth/doc/media/oauth/007acd70.png
0 → 100644
浏览文件 @
b564ce8a
26.5 KB
docs/oauth/doc/media/oauth/895f76da.png
0 → 100644
浏览文件 @
b564ce8a
11.9 KB
docs/oauth/doc/media/oauth/f403ad52.png
0 → 100644
浏览文件 @
b564ce8a
11.5 KB
docs/oauth/oschina.md
0 → 100644
浏览文件 @
b564ce8a
## 1. 申请应用
### 1.1 登录钉钉开发者中心
1.
登录开源中国:
[
开源中国
](
https://www.oschina.net/
)
2.
点击访问应用管理页面:
[
应用管理
](
https://www.oschina.net/openapi/client
)
### 1.2 创建第三方授权应用
1.
在开源中国应用管理页面,点击“创建应用”
2.
填写基本信息
![](
doc/media/oauth/007acd70.png
)
5.
创建后即可看到 应用ID 和 应用私钥。
![](
doc/media/oauth/895f76da.png
)
记录以下三个信息:
`应用ID`
、
`应用私钥`
和
`回调地址`
,后面我们会用到。
## 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
AuthOschinaRequest
(
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.AuthOschinaRequest
;
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
AuthOschinaRequest
(
AuthConfig
.
builder
()
.
clientId
(
"应用ID"
)
.
clientSecret
(
"应用私钥"
)
.
redirectUri
(
"回调地址"
)
.
build
());
}
}
```
授权链接访问成功后会看到以下页面内容:
![](
doc/media/oauth/f403ad52.png
)
点击“连接”即可完成百度的 OAuth 登录。
## 3. 授权结果
注:数据已脱敏
```
json
{
"code"
:
2000
,
"data"
:{
"avatar"
:
"https://oscimg.oschina.net/oscnet/up-2247e2b7c5c9907f70ba2648f9db112d.jpg!/both/50x50?t=1451008261000"
,
"blog"
:
"https://my.oschina.net/yadong0415"
,
"email"
:
"yadong.zhang0415@gmail.com"
,
"gender"
:
"FEMALE"
,
"location"
:
"北京 朝阳"
,
"nickname"
:
"HandsomeBoy丶"
,
"rawUserInfo"
:{
"gender"
:
"female"
,
"name"
:
"HandsomeBoy丶"
,
"location"
:
"北京 朝阳"
,
"id"
:
2564550
,
"avatar"
:
"https://oscimg.oschina.net/oscnet/up-2247e2b7c5c9907f70ba2648f9db112d.jpg!/both/50x50?t=1451008261000"
,
"email"
:
"yadong.zhang0415@gmail.com"
,
"url"
:
"https://my.oschina.net/yadong0415"
},
"source"
:
"OSCHINA"
,
"token"
:{
"accessToken"
:
"826c0ffaae486e45a657"
,
"expireIn"
:
604799
,
"refreshToken"
:
"dc83aa5aaafc786cf"
,
"uid"
:
"2aaa0"
},
"username"
:
"HandsomeBoy丶"
,
"uuid"
:
"2aa0"
}
}
```
## 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.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录