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

背景

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

流程

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

准备工作

创建应用

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

设置回调

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

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

设置回调地址

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

后端实现

引入第三方jar

 <dependency><groupId>com.alibaba.zwdd</groupId><artifactId>zwdd-sdk</artifactId><version>1.2.0</version><scope>system</scope><systemPath>${project.basedir}/lib/zwdd-sdk-java-1.2.0.jar</systemPath><!--路径--></dependency><dependency><groupId>joda-time</groupId><artifactId>joda-time</artifactId><version>2.10</version></dependency><dependency><groupId>com.alibaba</groupId><artifactId>fastjson</artifactId><version>1.2.47</version></dependency><dependency><groupId>org.apache.commons</groupId><artifactId>commons-lang3</artifactId><version>3.12.0</version> </dependency><dependency><groupId>org.apache.httpcomponents</groupId><artifactId>httpclient</artifactId><version>4.5.13</version> </dependency>

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

代码实现

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

Service接口

public interface ZheJiangDingTalkService {/*** 获取token* @param* @return*/String getToken();/*** 获取用户信息* @param authCode* @return*/ZheJiangUserInfoApiResult getUserInfo(String accessToken,String authCode);
}

Service实现

Service
public class ZheJiangDingTalkServiceImpl implements ZheJiangDingTalkService {@Resourceprivate DingDingProperties dingDingProperties;@Overridepublic String getToken() {try {ExecutableClient executableClient = init();return getToken(executableClient);} catch (Exception e) {e.printStackTrace();}return null;}private String getToken(ExecutableClient executableClient) {try {//executableClient保证单例PostClient intelligentGetClient = executableClient.newPostClient("/gettoken.json");OapiGettokenJsonRequest oapiGettokenJsonRequest = new OapiGettokenJsonRequest();//应用的唯一标识keyoapiGettokenJsonRequest.setAppkey(dingDingProperties.getAppKey());//应用的密钥oapiGettokenJsonRequest.setAppsecret(dingDingProperties.getAppSecret());//获取结果String apiResult = intelligentGetClient.post();Type type = new TypeToken<ZheJiangTokenApiResult<ZheJiangTokenBaseApiResult>>() {}.getType();ZheJiangTokenApiResult<ZheJiangTokenBaseApiResult> tokenApiResult = GsonUtil.stringToBean(apiResult, type);if (tokenApiResult.success()) {ZheJiangTokenBaseApiResult.ZheJiangTokenApiResult resultData = tokenApiResult.getContent().getData();String accessToken = resultData.getAccessToken();return accessToken;}return null;} catch (Exception e) {e.printStackTrace();}return null;}@Overridepublic ZheJiangUserInfoApiResult getUserInfo(String accessToken,String code) {ExecutableClient init = init();IntelligentGetClient  intelligentPostClient = init.newIntelligentGetClient("/rpc/oauth2/getuserinfo_bycode.json");OapiRpcOauth2GetuserinfoBycodeJsonRequest oapiRpcOauth2DingtalkAppUserJsonRequest = new OapiRpcOauth2GetuserinfoBycodeJsonRequest ();//登录access_tokenoapiRpcOauth2DingtalkAppUserJsonRequest.setAccess_token(accessToken);//临时授权码 //回调的码oapiRpcOauth2DingtalkAppUserJsonRequest.setCode(code);//获取结果OapiRpcOauth2GetuserinfoBycodeJsonResponse apiResult = intelligentPostClient.get(oapiRpcOauth2DingtalkAppUserJsonRequest);String content = apiResult.getContent();Type type = new TypeToken<ZheJiangTokenApiResult<ZheJiangBaseApiResult<ZheJiangUserInfoApiResult>>>() {}.getType();ZheJiangTokenApiResult<ZheJiangBaseApiResult<ZheJiangUserInfoApiResult>> tokenApiResult = GsonUtil.stringToBean(content, type);if(tokenApiResult.success()) {return tokenApiResult.getContent().getData();}return null;}private ExecutableClient init(){ExecutableClient executableClient =ExecutableClient.getInstance();executableClient.setAccessKey(dingDingProperties.getAppKey());executableClient.setSecretKey(dingDingProperties.getAppSecret());executableClient.setDomainName(dingDingProperties.getDomainName());executableClient.setProtocal("https");executableClient.init();return executableClient;}}

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

工具类

public class GsonUtil {/*** 不用创建对象,直接使用Gson.就可以调用方法*/private static Gson gson = null;private static JsonParser jsonParser = null;/*** 判断gson对象是否存在了,不存在则创建对象*/static {//gson = new Gson();// 当使用GsonBuilder方式时属性为空的时候输出来的json字符串是有键值key的,显示形式是"key":null，而直接new出来的就没有"key":null的gson = new GsonBuilder().setDateFormat("yyyy-MM-dd HH:mm:ss").create();if(jsonParser == null ){jsonParser = new JsonParser();}}private GsonUtil() {}}/*** 将json转成特定的cls的对象* @param gsonString* @param cls* @return*/public static <T> T stringToBean(String gsonString, Class<T> cls) {T t = null;if (gson != null) {//传入json对象和对象类型,将json转成对象t = gson.fromJson(gsonString, cls);}return t;}public static <T> T stringToBean(String gsonString, Type type) {T t = null;if (gson != null) {//传入json对象和对象类型,将json转成对象t = gson.fromJson(gsonString, type);}return t;}
}
@Component
@ConfigurationProperties(prefix = "dingtalk.msg")
@Setter
@Getter
public class DingDingProperties {public String appKey = "xx";public String appSecret = "xxx";private String domainName="openplatform.dg-work.cn";}

实体

@Setter
@Getter
@ToString
public class ZheJiangBaseApiResult<T> {private T data;private boolean success;private String requestId;private String responseMessage;private String responseCode;private String bizErrorCode;public boolean isSuccess(){return ("0").equals(this.bizErrorCode);}}
@Setter
@Getter
@ToString
public class ZheJiangTokenApiResult<T> {private T content;private String bizErrorCode;private boolean success;public boolean success(){return ("0").equals(this.bizErrorCode) || success;}}
@Setter
@Getter
@ToString
public class ZheJiangTokenBaseApiResult {private ZheJiangTokenApiResult data;private boolean success;private String requestId;private String responseMessage;private String responseCode;private String bizErrorCode;@Setter@Getterpublic class ZheJiangTokenApiResult {private int expiresIn;private String accessToken;}}
@Setter
@Getter
@ToString
@NoArgsConstructor
public class ZheJiangUserInfoApiResult {public Integer accountId;private boolean success;public String lastName;public String clientId;public Integer realmId;public String realmName;public String namespace;public String nickNameCn;public String tenantUserId;public String account;public String employeeCode;}

额外的pom文件

    <!-- gson --><dependency><groupId>com.google.code.gson</groupId><artifactId>gson</artifactId><version>2.8.5</version></dependency><dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId><optional>true</optional></dependency><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency>

注意事项

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

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

参考链接

专有钉钉