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

背景

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

流程

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

准备工作

创建应用

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

设置回调

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

凭证与基础信息 中的 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 {
@Resource
private DingDingProperties dingDingProperties;
@Override
public 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();
//应用的唯一标识key
oapiGettokenJsonRequest.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;
}
@Override
public ZheJiangUserInfoApiResult getUserInfo(String accessToken,String code) {
ExecutableClient init = init();
IntelligentGetClient  intelligentPostClient = init.newIntelligentGetClient("/rpc/oauth2/getuserinfo_bycode.json");
OapiRpcOauth2GetuserinfoBycodeJsonRequest oapiRpcOauth2DingtalkAppUserJsonRequest = new OapiRpcOauth2GetuserinfoBycodeJsonRequest ();
//登录access_token
oapiRpcOauth2DingtalkAppUserJsonRequest.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
@Getter
public 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就可以了。

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

参考链接

专有钉钉