实操 maxkey对接三方文档

在这里插入图片描述

实操 maxkey 对接三方文档

概述
前置准备：
- MaxKey 安装与配置：
- 第三方系统准备
- 网络环境
对接三方配置
- oauth2协议对接
- - 导入jar包（调接口）
  - 权限加回调
  - 重定向
  - 获取token
  - 处理业务
- api对接三方
- - 获取api凭证
  - 配置 MaxKey
  - 更新代码

概述

最近在搞maxkey对接三方，做个记录，方便后续对接。

前置准备：

MaxKey 安装与配置：

确保 MaxKey 已经正确安装并运行具体可参考 maxkey本地运行指南

前端配置
node.js使用v20 运行时添加忽略否则报错
yarn install --ignore-engines

第三方系统准备

确认第三方系统已准备好，并且能够提供必要的 API 接口或 OAuth2.0 服务

网络环境

确保 MaxKey 服务器能够访问第三方系统的网络。

对接三方配置

oauth2协议对接

第三方系统对接maxkey的OAuth2 以me-vue为例

导入jar包（调接口）

1.导入maxkey的jar包或者从官网自己调用接口
在这里插入图片描述

权限加回调

2.me-vue权限中加入白名单回调页面callback
在这里插入图片描述

重定向

3.修改login页面，页面进入之后调用后台接口回去重定向地址，跳转重定向页面
在这里插入图片描述

获取token

4.重定向页面里会写入回调的页面，输入账号密码登录成功后进入回调页面，回调页面携带maxkey给的code调用后台接口通过code去maxkey获取token，根据token获取用户信息

在这里插入图片描述

处理业务

5.根据返回的用户信息处理业务逻辑

api对接三方

获取api凭证

从第三方系统获取 API 凭证（ Client ID 和 Client Secret）。

配置 MaxKey

修改 MaxKey 配置文件

maxkey.oauth2.clientId=your_client_id
maxkey.oauth2.clientSecret=your_client_secret
maxkey.oauth2.redirectUri=http://your-maxkey-server/callback
maxkey.oauth2.authorizationUri=https://thirdparty.com/oauth/authorize
maxkey.oauth2.tokenUri=https://thirdparty.com/oauth/token
maxkey.oauth2.userInfoUri=https://thirdparty.com/api/userinfo

更新代码

引入三方库，编写适配器，注册适配器
在这里插入图片描述

public class ThirdPartyAdapter {private String clientId;private String clientSecret;private String redirectUri;private String authorizationUri;private String tokenUri;private String userInfoUri;}