使用JustAuth集成企业微信

JustAuth 又㕛叒叕添加新平台啦~

此次更新带来的是 企业微信,本文将带领大家使用 JustAuth 快速集成 企业微信 的第三方登录。

1. 注册并登录企业微信

地址:https://work.weixin.qq.com/wework_admin/loginpage_wx?from=myhome_openApi

如果没有企业可以点击 企业注册

image-20190806155101145

2. 创建企业微信应用

导航栏 – 应用管理 – 自建 – 创建应用

image-20190806155308745

选择合适的应用logo,为应用取个名,同时设置应用的可见范围,创建应用

image-20190806155353393

3. 应用设置及基本关键参数

3.1. 应用设置

创建完应用之后,拖到应用最下方,配置应用信息

image-20190806155804425

使用 JustAuth 基本都是网页应用,所以这一步我们直接选择 Web网页设置授权回调域

image-20190806160104626

注意:这里 授权回调域 不需要指定 前缀,后缀 等信息,示例如下图

关于授权回调域存在疑问的童鞋请看这里:https://open.work.weixin.qq.com/api/doc#90000/90135/90988

image-20190806160302321

3.2. 基本关键参数获取

使用 JustAuth 进行企业微信登录需要 4 个参数信息:client-idclient-secretredirect-uriagent-id

3.2.1. agent-id 及 client-secret 信息

agent-idclient-secret这两个信息均在 应用管理 里可以查看

image-20190806161343874

3.2.2. client-id 信息

client-id 信息在 我的企业 中可以找到,该信息即 企业ID

image-20190806161551756

3.2.3. redirect-uri 信息

回调地址是根据我们前面配置的 授权回调域 来的,我设置的是 oauth.xkcoding.com ,项目里我的回调地址指定为 http://oauth.xkcoding.com/demo/oauth/wechat_enterprise/callback

4. 开发

4.1. 引入依赖

1
2
3
4
5
<dependency>
<groupId>com.xkcoding</groupId>
<artifactId>justauth-spring-boot-starter</artifactId>
<version>0.0.3-SNAPSHOT</version>
</dependency>

4.2. 修改配置文件

1
2
3
4
5
6
7
8
justauth:
enabled: true
type:
WECHAT_ENTERPRISE:
client-id: ww58**********6fbc
client-secret: 8G6PCr0****************************yzaPc78
redirect-uri: http://oauth.xkcoding.com/demo/oauth/wechat_enterprise/callback
agent-id: 10*******02

4.3. 编写 Controller 代码

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
/**
* <p>
* 测试 Controller
* </p>
*
* @author yangkai.shen
* @date Created in 2019-07-22 11:17
*/
@Slf4j
@RestController
@RequestMapping("/oauth")
@RequiredArgsConstructor(onConstructor_ = @Autowired)
public class TestController {
private final AuthRequestFactory factory;

@GetMapping
public List<String> list() {
return factory.oauthList();
}

@GetMapping("/login/{type}")
public void login(@PathVariable String type, HttpServletResponse response) throws IOException {
AuthRequest authRequest = factory.get(getAuthSource(type));
response.sendRedirect(authRequest.authorize(AuthStateUtils.createState()));
}

@RequestMapping("/{type}/callback")
public AuthResponse login(@PathVariable String type, AuthCallback callback) {
AuthRequest authRequest = factory.get(getAuthSource(type));
AuthResponse response = authRequest.login(callback);
log.info("【response】= {}", JSONUtil.toJsonStr(response));
return response;
}

private AuthSource getAuthSource(String type) {
if (StrUtil.isNotBlank(type)) {
return AuthSource.valueOf(type.toUpperCase());
} else {
return null;
}
}
}

代码地址:https://github.com/xkcoding/justauth-spring-boot-starter-demo

5. 效果演示

image-20190806162938367

image-20190806163011576

果然! 不得不说:whnb.wang

参考

  • 企业微信文档地址:https://open.work.weixin.qq.com/api/doc#90000/90135/90664

  • 获取AccessToken:https://open.work.weixin.qq.com/api/doc#90000/90135/91039

  • 构建登录二维码:https://open.work.weixin.qq.com/api/doc#90000/90135/91019

  • 获取用户身份:https://open.work.weixin.qq.com/api/doc#90000/90135/91437

  • 用户身份详细信息:https://open.work.weixin.qq.com/api/doc#90000/90135/90196

-------------本文结束  感谢您的阅读-------------
o(╯□╰)o我只要一毛钱的鼓励~~