最近有个需求,在钉钉内,点击微应用,获取用户身份,根据获取到的用户身份去企业内部的用户中心做校验,校验通过,相关子系统直接登陆;
就是在获取这个用户身份的时候,网上的资料七零八落的,找的人烦躁的很,所以自己记录一下;
实现这个要求,有好几种方式,使用ISV方式相对来说比较简单一点,获取的到的信息虽然没有其他方式那么全,但是也包含了百分之七八十的信息,少了角色信息之类的;
效果:(demo的GIT地址在文末)
说说步骤:
这个首页跳转地址,信任了以后,就可以直接使用js-sdk来获取用户code等相关信息,最方便的一种.
如果是别的页面,使用js-sdk 需要进行dd.config的初始化,这个初始化里面,包含了相关的权限校验.
2.应用创建完了以后,会生成一个agentID,
如果仅仅只是为了获取当前点击用户的信息,并且获取的位置是在这个首页地址的js里面,则大可以不用管这个信息,但是,如果需要更加复杂的操作,就需要获取这个ID,获取方法在创建完了以后,右上角的小三角下拉,有个设置,点进去就能看到
另外,关于js-sdk的需要鉴权的api信息查询地址:jsapi列表(是否需要dd.config校验)
列表里面不需要的接口调用,都不需要进行dd.config()
3.获取钉钉开发的corpID和corpSecert
一般获取上面的足够.web sso免登可能需要下面的SSOSecert;
4.准备工作做完
现在我们有以下信息:
corpID:
corpSecert:
agentID:
url:这个url就是你需要获取用户code的那个页面url
当然如果只是简单的获取用户信息,不需要进行dd.config的话,可以不用管agrntID和url
5.进入开发(这里只是做获取当前用户信息的示例)
(1).前端页面引入dingtalk.js
(2).在页面添加 获取code 的 js 代码,
(3).将获取的 code发送到后台处理
后台根据上一步返回的简单的,包含userid的信息,拿到userid
(5).返回给前台显示,或者进行后续开发
贴一贴这个流程中关键一点的代码:
前端页面在引入js 后,或有一个dd的全局变量,这个就是js-sdk,如果需要权限校验的,就要放在最前边
dd.ready(function() {
dd.runtime.permission.requestAuthCode({
corpId :"这里是你的corpID",
onSuccess :function(result) {var code =result.code;
alert(code);
//将code 发往后台处理
},
onFail :function(err) {
alert(‘出错了, ‘ +err);
}
});
});
后台处理部分:
AuthHelper.java 文末提供
在接收到授权码以后:
String accessToken =AuthHelper.getAccessToken(CORP_ID, CORP_SECRET);
String user= AuthHelper.getUserInfo(code, accessToken);
当返回正确的时候,这个user 里面结果大致是这样的:
{"errcode": 0,"errmsg": "ok","userid": "USERID","deviceId":"DEVICEID","is_sys": true,"sys_level": 0|1|2}
然后根据里面的userid,获取详细的用户信息:
String userall = AuthHelper.getUser(userid, accessToken);
返货正确的话,这个userall里面的结果大致是:(具体查看钉钉开发文档)
{"errcode": 0,"unionid": "PiiiPyQqBNBii0HnCJ3zljcuAiEiE","openId": "PiiiPyQqBNBii0HnCJ3zljcuAiEiE","roles": [{"id": 23003585,"name": "财务","groupName": "职务"}],"remark": "备注","userid": "04232334556237185","isLeaderInDepts": "{1:false}","isBoss": false,"hiredDate": 1520265600000,"isSenior": false,"tel": "010-88996533","department": [1,2],"workPlace": "北京市朝阳区","email": "ceshi@aliyun.com","orderInDepts": "{1:71738366882504}","dingId": "$:LWCP_v1:$aTPvVHhhsCMtDZRQ1xbYGg==","mobile": "15901516821","errmsg": "ok","active": false,"avatar": "dingtalk.com/abc.jpg","isAdmin": false,"isHide": false,"jobnumber": "001","name": "测试名字","extattr": {},"stateCode": "86","position": "总监"}
然后简单的获取信息到此结束;
注意的是:
如果需要更多的操作,就需要在前端页面进行dd.config的初始化,这个里面的所需要的sign,可以在后台根据相关信息生成,是必不可少的,生成规则见AuthHelper.java(其他工具类见文末的 git 地址)
importjava.io.IOException;importjava.io.UnsupportedEncodingException;importjava.security.MessageDigest;importjava.security.NoSuchAlgorithmException;importjava.util.Formatter;importcn.jlhd.util.HttpHelper;importcn.jlhd.util.JsonUtil;importcn.jlhd.util.ReturnUtil;/***
* 1.获取accessToken
* 2.获取jsapi中的ticket
* 3.生成jsapiz中的鉴权sign
* 4.根据传入的临时code获取用户的基本信息,入userinfo
* 5.根据userid获取详细用户信息
*
*@authorlnexin
**/
public classAuthHelper {//钉钉api相关
static String TOKEN_URL = "https://oapi.dingtalk.com/gettoken";static String TICKET_URL = "https://oapi.dingtalk.com/get_jsapi_ticket";static String USER_INFO_URL = "https://oapi.dingtalk.com/user/getuserinfo";static String USER_ALL_URL = "https://oapi.dingtalk.com/user/get";//调整到1小时50分钟
public static final long cacheTime = 1000 * 60 * 55 * 2;private static String ACCESS_TOKEN = null;private static String JSAPI_TICKET = null;private static long LAST_TIME = 0;/***
*@paramcorpId
*@paramcorpSecert
*@return与钉钉服务器请求生成的accessToken*/
public staticString getAccessToken(String corpId, String corpSecert) {long curTime =System.currentTimeMillis();long differ = curTime -LAST_TIME;if (ACCESS_TOKEN != null && differ
ACCESS_TOKEN=requestAccessToken(corpId, corpSecert);
LAST_TIME=curTime;returnACCESS_TOKEN;
}/***
*@paramaccessToken
*
*@seegetAccess_Token(String corpId, String corpSecert) 生成的access_token
*@return一个用于js鉴权的ticket*/
public staticString getJsapiTicket(String accessToken) {long curTime =System.currentTimeMillis();long differ = curTime -LAST_TIME;if (JSAPI_TICKET != null && differ
}
JSAPI_TICKET=requestJsapiTicket(accessToken);returnJSAPI_TICKET;
}/*** 根据传入的相关参数生成sign
*
*@paramticket
*@paramnonceStr
*@paramtimeStamp
*@paramurl
*@return
*/
public static String sign(String ticket, String nonceStr, longtimeStamp, String url) {
StringBuffer plain= newStringBuffer();
plain.append("jsapi_ticket=").append(ticket);
plain.append("&noncestr=").append(nonceStr);
plain.append("×tamp=").append(String.valueOf(timeStamp));
plain.append("&url=").append(url);
MessageDigest sha;try{
sha= MessageDigest.getInstance("SHA-1");
sha.reset();
sha.update(plain.toString().getBytes("UTF-8"));returnbytesToHex(sha.digest());
}catch(NoSuchAlgorithmException e) {
e.printStackTrace();
}catch(UnsupportedEncodingException e) {
e.printStackTrace();
}return null;
}private staticString requestAccessToken(String corpId, String corpSecert) {
StringBuffer url= newStringBuffer(TOKEN_URL);
url.append("?corpid=").append(corpId);
url.append("&corpsecret=").append(corpSecert);
String result= null;try{
result=HttpHelper.sendGet(url.toString());
}catch(IOException e) {
result= ReturnUtil.result("-1","请求accessTokenc出错!corpid:" + corpId + ",corpsecert:" + corpSecert + "异常信息:" +e);
}
return JsonUtil.getJsonNode(result).get("access_token").asText();
}private staticString requestJsapiTicket(String accessToken) {
StringBuffer url= newStringBuffer(TICKET_URL);
url.append("?access_token=").append(accessToken);
String result= null;try{
result=HttpHelper.sendGet(url.toString());
}catch(IOException e) {
result= ReturnUtil.result("-1", "请求JsapiTicket出错!accessToken:" + accessToken + "异常信息:" +e);
}
return JsonUtil.getJsonNode(result).get("ticket").asText();
}private static String bytesToHex(byte[] hash) {
Formatter formatter= newFormatter();for (byteb : hash) {
formatter.format("%02x", b);
}
String result=formatter.toString();
formatter.close();returnresult;
}/*** 获取用户信息
*
*@paramcode
* 用户相应的临时code
*@paramtoken
* 根据相应corpid和corpsecret生成的access_token
*@return用户ID等相关信息*/
public staticString getUserInfo(String code, String accessToken) {
StringBuffer url= newStringBuffer(USER_INFO_URL);
url.append("?access_token=").append(accessToken);
url.append("&code=").append(code);
String result= null;try{
result=HttpHelper.sendGet(url.toString());
}catch(IOException e) {
result= ReturnUtil.result("-1", "请求User信息出错!code:" + code + "异常信息:" +e);
}returnresult;
}/*** 获取用户详细信息
*@paramuserid 在某个corpid下的唯一用户userid
*@paramaccessToken 据相应corpid和corpsecret生成的access_token
*@return
*/
public staticString getUser(String userid, String accessToken) {
StringBuffer url= newStringBuffer(USER_ALL_URL);
url.append("?access_token=").append(accessToken);
url.append("&userid=").append(userid);
String result= null;try{
result=HttpHelper.sendGet(url.toString());
}catch(IOException e) {
result= ReturnUtil.result("-1", "请求User信息出错!userid:" + userid + "异常信息:" +e);
}returnresult;
}
}
做了一个简单demo获取用户信息: