对接专有钉钉(浙政钉)登陆步骤

配景

因为项目需要对接浙政钉，我想应该和之前对接阿里云的钉钉登陆钉钉登陆类似，就上网搜刮看看，出现了个专有钉钉的概念，就一时间搞不清楚，钉钉，专有钉钉，浙政钉的区别，后续稍微明白了点，不肯定完全正确哈。 可给大家做参考。
浙政钉: 线上环境使用的，一样寻常是当局用的比较多。 在政务外网
钉钉：一样寻常是企业用的，公网使用。
专有钉钉: 浙政钉的公网测试版本。专有钉钉下载
流程

参考链接中有流程，我这面的话在贴一张流程图

预备工作

创建应用

登陆专有钉钉，这里的话，如果是首次的话我感觉比较麻烦，没有注册之类的。 我都是让同事把我加到他的测试构造中的，就跳过比较麻烦的点，以是我就不清楚具体怎么注册了。 登陆之后创建应用
根据自己的需求来选择，这里我选择了扫码登陆。

设置回调

应用创建成功之后点击详情

凭证与基础信息 中的 App Key 和App Secret 这二我们后端是需要使用的，先简朴看一下。到时候可以设置成配置。

设置回调地点

回调地点的作用:可参考在流程中政务登陆服务给我们后端临时授权码的那一步。
后端实现

引入第三方jar

2.         <dependency>
3.             <groupId>com.alibaba.zwdd</groupId>
4.             <artifactId>zwdd-sdk</artifactId>
5.             <version>1.2.0</version>
6.             <scope>system</scope>
7.             <systemPath>${project.basedir}/lib/zwdd-sdk-java-1.2.0.jar</systemPath><!--路径-->
8.         </dependency>
9.         <dependency>
10.             <groupId>joda-time</groupId>
11.             <artifactId>joda-time</artifactId>
12.             <version>2.10</version>
13.         </dependency>
14.         <dependency>
15.             <groupId>com.alibaba</groupId>
16.             <artifactId>fastjson</artifactId>
17.             <version>1.2.47</version>
18.         </dependency>
19.         <dependency>
20.             <groupId>org.apache.commons</groupId>
21.             <artifactId>commons-lang3</artifactId>
22.             <version>3.12.0</version>
23.         </dependency>
24.         <dependency>
25.             <groupId>org.apache.httpcomponents</groupId>
26.             <artifactId>httpclient</artifactId>
27.             <version>4.5.13</version>
28.         </dependency>

复制代码

这个zwdd-sdk-java-1.2.0.jar没有在中央仓库中，需要自己下载引入。
下载链接
引入也很简朴，在项目目录创建一个lib文件夹，放进去就可以了。上面有写好怎么引入当地包的。
代码实现

这里我们就实现二个接口，一个是获取token 一个是获取用户信息。
Service接口

1. public interface ZheJiangDingTalkService {
2.     /**
3.      * 获取token
4.      * @param
5.      * @return
6.      */
7.     String getToken();
9.     /**
10.      * 获取用户信息
11.      * @param authCode
12.      * @return
13.      */
14.     ZheJiangUserInfoApiResult getUserInfo(String accessToken,String authCode);
15. }

复制代码

Service实现

1. Service
2. public class ZheJiangDingTalkServiceImpl implements ZheJiangDingTalkService {
3.     @Resource
4.     private DingDingProperties dingDingProperties;
7.     @Override
8.     public String getToken() {
9.         try {
11.             ExecutableClient executableClient = init();
12.             return getToken(executableClient);
13.         } catch (Exception e) {
14.             e.printStackTrace();
15.         }
16.         return null;
17.     }
20.     private String getToken(ExecutableClient executableClient) {
21.         try {
22.             
23.             //executableClient保证单例
24.             PostClient intelligentGetClient = executableClient.newPostClient("/gettoken.json");
25.             OapiGettokenJsonRequest oapiGettokenJsonRequest = new OapiGettokenJsonRequest();
26.             //应用的唯一标识key
27.             oapiGettokenJsonRequest.setAppkey(dingDingProperties.getAppKey());
28.             //应用的密钥
29.             oapiGettokenJsonRequest.setAppsecret(dingDingProperties.getAppSecret());
30.             //获取结果
31.             String apiResult = intelligentGetClient.post();
33.             Type type = new TypeToken<ZheJiangTokenApiResult<ZheJiangTokenBaseApiResult>>() {}.getType();
34.             ZheJiangTokenApiResult<ZheJiangTokenBaseApiResult> tokenApiResult = GsonUtil.stringToBean(apiResult, type);
36.             if (tokenApiResult.success()) {
37.                 ZheJiangTokenBaseApiResult.ZheJiangTokenApiResult resultData = tokenApiResult.getContent().getData();
38.                 String accessToken = resultData.getAccessToken();
39.                
40.                 return accessToken;
41.             }
42.             return null;
43.         } catch (Exception e) {
44.             e.printStackTrace();
45.         }
46.         return null;
47.     }
50.     @Override
51.     public ZheJiangUserInfoApiResult getUserInfo(String accessToken,String code) {
52.         ExecutableClient init = init();
53.         IntelligentGetClient  intelligentPostClient = init.newIntelligentGetClient("/rpc/oauth2/getuserinfo_bycode.json");
54.         OapiRpcOauth2GetuserinfoBycodeJsonRequest oapiRpcOauth2DingtalkAppUserJsonRequest = new OapiRpcOauth2GetuserinfoBycodeJsonRequest ();
55.         //登录access_token
56.         oapiRpcOauth2DingtalkAppUserJsonRequest.setAccess_token(accessToken);
57.         //临时授权码 //回调的码
58.         oapiRpcOauth2DingtalkAppUserJsonRequest.setCode(code);
59.         //获取结果
60.         OapiRpcOauth2GetuserinfoBycodeJsonResponse apiResult = intelligentPostClient.get(oapiRpcOauth2DingtalkAppUserJsonRequest);
61.         String content = apiResult.getContent();
62.         Type type = new TypeToken<ZheJiangTokenApiResult<ZheJiangBaseApiResult<ZheJiangUserInfoApiResult>>>() {}.getType();
63.         ZheJiangTokenApiResult<ZheJiangBaseApiResult<ZheJiangUserInfoApiResult>> tokenApiResult = GsonUtil.stringToBean(content, type);
64.         if(tokenApiResult.success()) {
65.             return tokenApiResult.getContent().getData();
66.         }
67.         return null;
68.     }
70.     private ExecutableClient init(){
71.         ExecutableClient executableClient =ExecutableClient.getInstance();
72.         executableClient.setAccessKey(dingDingProperties.getAppKey());
73.         executableClient.setSecretKey(dingDingProperties.getAppSecret());
74.         executableClient.setDomainName(dingDingProperties.getDomainName());
75.         executableClient.setProtocal("https");
76.         executableClient.init();
77.         return executableClient;
78.     }
80. }

复制代码

这里我们使用了Gson和创建了几个对象，这里的代码的话，我简朴贴一下，看你们是否乐意使用，不乐意的话，可自己写的。
工具类

1. public class GsonUtil {
3.     /**
4.      * 不用创建对象,直接使用Gson.就可以调用方法
5.      */
6.     private static Gson gson = null;
8.     private static JsonParser jsonParser = null;
10.     /**
11.      * 判断gson对象是否存在了,不存在则创建对象
12.      */
13.     static {
14.         //gson = new Gson();
15.         // 当使用GsonBuilder方式时属性为空的时候输出来的json字符串是有键值key的,显示形式是"key":null，而直接new出来的就没有"key":null的
16.         gson = new GsonBuilder().setDateFormat("yyyy-MM-dd HH:mm:ss").create();
18.         if(jsonParser == null ){
19.             jsonParser = new JsonParser();
20.         }
21.     }
23.     private GsonUtil() {}
24.     }
25.       /**
26.      * 将json转成特定的cls的对象
27.      * @param gsonString
28.      * @param cls
29.      * @return
30.      */
31.     public static <T> T stringToBean(String gsonString, Class<T> cls) {
32.         T t = null;
33.         if (gson != null) {
34.             //传入json对象和对象类型,将json转成对象
35.             t = gson.fromJson(gsonString, cls);
36.         }
37.         return t;
38.     }
39.     public static <T> T stringToBean(String gsonString, Type type) {
40.         T t = null;
41.         if (gson != null) {
42.             //传入json对象和对象类型,将json转成对象
43.             t = gson.fromJson(gsonString, type);
44.         }
45.         return t;
46.     }
47. }
48. @Component
49. @ConfigurationProperties(prefix = "dingtalk.msg")
50. @Setter
51. @Getter
52. public class DingDingProperties {
54.    
55.     public String appKey = "xx";
57.     public String appSecret = "xxx";
59.     private String domainName="openplatform.dg-work.cn";
61. }

复制代码

实体

1. @Setter
2. @Getter
3. @ToString
4. public class ZheJiangBaseApiResult<T> {
5.     private T data;
6.     private boolean success;
7.     private String requestId;
8.     private String responseMessage;
9.     private String responseCode;
10.     private String bizErrorCode;
12.     public boolean isSuccess(){
13.         return ("0").equals(this.bizErrorCode);
14.     }
16. }
17. @Setter
18. @Getter
19. @ToString
20. public class ZheJiangTokenApiResult<T> {
21.     private T content;
22.     private String bizErrorCode;
24.     private boolean success;
26.     public boolean success(){
27.         return ("0").equals(this.bizErrorCode) || success;
28.     }
31. }
32. @Setter
33. @Getter
34. @ToString
35. public class ZheJiangTokenBaseApiResult {
36.     private ZheJiangTokenApiResult data;
37.     private boolean success;
38.     private String requestId;
39.     private String responseMessage;
40.     private String responseCode;
41.     private String bizErrorCode;
43.     @Setter
44.     @Getter
45.     public class ZheJiangTokenApiResult {
46.         private int expiresIn;
47.         private String accessToken;
48.     }
51. }
52. @Setter
53. @Getter
54. @ToString
55. @NoArgsConstructor
56. public class ZheJiangUserInfoApiResult {
57.     public Integer accountId;
58.     private boolean success;
59.     public String lastName;
60.     public String clientId;
61.     public Integer realmId;
62.     public String realmName;
63.     public String namespace;
64.     public String nickNameCn;
65.     public String tenantUserId;
66.     public String account;
67.     public String employeeCode;
69.    
70. }

复制代码

额外的pom文件

1.     <!-- gson -->
2.         <dependency>
3.             <groupId>com.google.code.gson</groupId>
4.             <artifactId>gson</artifactId>
5.             <version>2.8.5</version>
6.         </dependency>
7.          <dependency>
8.             <groupId>org.projectlombok</groupId>
9.             <artifactId>lombok</artifactId>
10.             <optional>true</optional>
11.         </dependency>
12.          <dependency>
13.             <groupId>org.springframework.boot</groupId>
14.             <artifactId>spring-boot-starter-web</artifactId>
15.         </dependency>

复制代码

注意事项

DingDingProperties 中的domainName 记得正式环境更改成openplatform-pro.ding.zj.gov.cn
让客户提供下正式环境下的 app-key和app-secret就可以了。

剩下的二维码和对接就交给前端的同事来对接就好了。
参考链接

专有钉钉

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。