一、前言

哈哈，这是我的第一篇博客。

先说一下这个小功能的具体场景：

用户登录钉钉app，点击微应用，获取当前用户的信息，与H5系统的数据库的用户信息对比，如果存在该用户，则点击后直接进入H5系统的首页，否则显示“您无权限”。

补充：又加了一个小需求，就是免登成功，会给该用户发条消息

我是参考钉钉开发文档实现的这个小功能，文档地址：https://ding-doc.dingtalk.com/doc#/serverapi2/clotub

二、准备工作

需要创建一个微应用：https://open-dev.dingtalk.com

1.是在企业内部开发中创建H5微应用，不是第三方企业应用中

企业内部开发：企业内部开发是指“开发企业内部应用”供企业内部的人员使用。企业可以选择由企业内部的开发者进行开发，或者由企业授权定制服务商进行开发。

第三方企业应用：第三方企业应用开发，是指开发者以钉钉、企业之外的第三方身份，基于钉钉的开放能力开发应用，并提供给钉钉上的其他组织使用。（哈哈，这个区别我是直接copy文档中的）

2.H5工程中，创建的一个前端页面ddNoLogin.html（哈哈，这个起名有点中文式英语，因为我没有找到合适的英文单词）：

该页面是用来获取免登授权码，然后把该code传递给后台接口的。

3.填写公司服务器的公网IP

可以敲命令查看该ip：curl ifconfig.me

4.微应用创建好，会生成三个参数，

agentId、appKey、appSecret

外加一个corpId（钉钉开发者平台的首页中有显示），这四个参数值是固定的，后续开发需用

5.接口权限

高级权限-企业通讯录中的接口都需要给开通

6.最后发布应用

三、功能开发

哈哈，要开始敲代码了

1.获取免登授权码code

这里调用的是钉钉JS-API中的方法，本功能调用的方法是不需要鉴权的，如果需要鉴权，则还需先dd.config。

关于功能方法是否需要鉴权，可以去查看JSAPI总览

ddNoLogin.html：

<!DOCTYPE html>

<html>

<head>

    <title>微应用登陆</title>

    <meta charset="utf-8">

    <meta name="viewport" content="width=device-width,initial-scale=1 user-scalable=0" />

    <script src="https://cdn.bootcss.com/jquery/3.3.1/jquery.min.js"></script>

    <script type="text/javascript" src="http://g.alicdn.com/dingding/open-develop/1.9.0/dingtalk.js"></script>

</head>

<body>

<div id="ddNoLogin"></div>

<script type="text/javascript">

        dd.ready(function() {

        //1.获取免登授权码code

        dd.runtime.permission.requestAuthCode({

            corpId : corpId ,  //企业id

            onSuccess : function(result) {

                var code = result.code;

                getUserInfo(code);   //通过该code可以获取用户身份

            },

            onFail : function(err) {

                alert('出错了, ' + err);

            }

        });

    });

        function getUserInfo(code) {

        $.ajax({

            type : "GET",

            url : "/xxx/noLogin?code=" + code,

            async : false,

            dataType : 'json',

            contentType : "application/json;charset=utf-8",

            success : (function(res) {

                if(res.code == "0000"){

                       window.location.href = '/#/xxxxx';

                                }else{

                                   $('#ddNoLogin').html(res.msg);

                                }

            }),

        });

    }

</script>

</body>

</html>

获取code的实现是需要用前端JS去写的

2.获取access_token

钉钉提供了开放的api后台接口，这里通过appkey和appsecret获取token，请求路径：https://oapi.dingtalk.com/gettoken?appkey=key&appsecret=secret

该token有效期是2个小时，有效期内重复获取，会返回相同结果，并自动续期，

故这里我的实现是：定时刷新token，每隔1小时50分钟去获取钉钉的token，并缓存到redis中（我把钉钉的相关配置都放入到application.yml中了）

DdTokenTask.java：

/**

 * 定时获取钉钉的token

 */

@Component

@EnableScheduling

public class DdTokenTask {

    @Autowired

    private JedisClient jedisClient;

    public static final long cacheTime = 1000 * 60 * 55 * 2;//1小时50分钟

    @Value("${dtalk.tokenUrl}")

    private String tokenUrl;

    @Value("${dtalk.app.key}")

    private String appKey;

    @Value("${dtalk.app.secret}")

    private String appSecret;

    @Value("${dtalk.redisTokenKey}")

    private String tokenKey;

    @Value("${dtalk.taskRun}")

    private String taskRun;

    /**

     * 每隔1小时50分钟获取钉钉的access_token

     */

    @Scheduled(fixedRate = cacheTime)

    @Async

    public void getDdTokenTask(){

        if("true".equals(taskRun)){

            //刷新

            System.out.println("--->>>>>-------------获取钉钉token的定时任务开始了："+ DateUtil.formatDateToString(new Date(), "HH:mm:ss"));

            String accessTokenUrl = tokenUrl + "?appkey=" + appKey + "&appsecret=" + appSecret;

            //访问获取access_token   有效期是2小时

            String accessToken = JsonUtil.getJsonNode(HttpUtil.doGet(accessTokenUrl)).get("access_token").asText();

            //放入到redis中

            jedisClient.set(tokenKey, accessToken);

            System.out.println("--->>>>>-------------获取钉钉token的定时任务结束了，token："+accessToken);

        }

    }

    /*private String getAccessToken(){

        //需引入SDK，公司私服没有

        DefaultDingTalkClient client = new

        DefaultDingTalkClient("https://oapi.dingtalk.com/gettoken");

        OapiGettokenRequest request = new OapiGettokenRequest();

        request.setAppkey("appkey");

        request.setAppsecret("appsecret");

        request.setHttpMethod("GET");

        OapiGettokenResponse response = client.execute(request);

        return "";

    }*/

}

（哈哈，其实文档中提供了钉钉SDK的java写法，不过公司私服没有该SDK，所以我就直接用htttp请求了）

3.获取用户userid

通过免登授权码和access_token获取用户的userid，请求路径：https://oapi.dingtalk.com/user/getuserinfo?access_token=access_token&code=code

4.获取用户详情

请求路径：https://oapi.dingtalk.com/user/get?access_token=ACCESS_TOKEN&userid=shaocui

会返回用户的姓名、手机号等所有信息

DdLoginController.java：

@RestController

@RequestMapping("/ddUser")

@Api(value = "/ddUser", description = "钉钉H5微应用登录", tags = {"DdLoginController"})

public class DdLoginController {

    @Autowired

    private JedisClient jedisClient;

    @Value("${dtalk.userUrl}")

    private String userUrl;

    @Value("${dtalk.userDetailUrl}")

    private String userDetailUrl;

    @Value("${dtalk.redisTokenKey}")

    private String tokenKey;

    @Value("${dtalk.agentId}")

    private Integer agentId;

    @GetMapping("/noLogin")

    @ApiOperation( "钉钉免登")

    @ApiImplicitParam(paramType = "query", name = "code", value = "免登授权码", dataType = "String")

    public WebResponse noLogin(@RequestParam("code") String code, HttpServletResponse response){

        //2.获取access_token

        String accessToken = jedisClient.get(tokenKey);

        //3.获取用户userid

        String userIdUrl =userUrl + "?access_token=" + accessToken + "&code=" + code;

        //访问获取userid

        JsonNode user = JsonUtil.getJsonNode(HttpUtil.doGet(userIdUrl));

        if(user.get("errcode").asInt() != 0){

            //有些公司的公网ip不固定，导致微应用中设置的不对，这里就会报错

            return WebResponse.resFail(user.get("errmsg").asText());

        }

        String userId = user.get("userid").asText();

        //4.获取用户详情  手机号

        String userInfoUrl = userDetailUrl + "?access_token=" + accessToken + "&userid=" + userId;

        //访问获取mobile

        JsonNode userInfo = JsonUtil.getJsonNode(HttpUtil.doGet(userInfoUrl));

        String mobile = userInfo.get("mobile").asText();

        System.out.println("钉钉用户的手机号："+mobile);

        //通过手机号获取该用户

        SysUser sysUser = 。。。。。;

        if(sysUser == null){

            //不存在该用户

            return WebResponse.resFail("您无权限访问", null);

        }

        。。。。。。

        //钉钉发送免登成功消息给用户

        sendMessage(accessToken, userId, userInfo.get("name").asText());

        return WebResponse.resSuccess("免登成功", loginUserInfo);

    }

    //钉钉发送消息给用户

    private void sendMessage(String token, String userId, String userName){

        String messageUrl = "https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token="+token;

        Map<String, Object> map = new HashMap<>();

        map.put("agent_id", agentId.longValue());

        map.put("userid_list", userId);

        map.put("to_all_user", false);

        String content = "用户"+userName+"在"+ DateUtil.formatDateToString(new Date(), "yyyy-MM-dd HH:mm:ss")+"时成功登录xxH5端，并进入到xxx页面";

        String msg = "{\"msgtype\":\"text\",\"text\":{\"content\":"+"\""+content+"\""+"}}";

        JSONObject jsonObj = JSONObject.parseObject(msg);

        map.put("msg",jsonObj);

        HttpUtil.doPost(messageUrl, map, "UTF-8", 20000, null);

    }

}

（哈哈，那个。。。。。处的代码是实现系统认证成功后的具体操作，故这里省略）

到此钉钉免登就实现了，然后免登成功后给用户发送消息

5.工作通知消息

POST请求，请求路径：https://oapi.dingtalk.com/topapi/message/corpconversation/asyncsend_v2?access_token=ACCESS_TOKEN

请求体{agent_id、userid_list、dept_id_list、to_all_user、msg}

注意：

给同一个用户发送相同的内容，一天只能发一次；发送不同的内容，一天可以500次，

故这里我在发送的消息中添加了当前时间。

（哈哈，一些细节的东西我都写在代码的注释里了，最后发现这个小功能好像就一点点代码量）

用java实现“钉钉微应用，免登进入某H5系统首页“功能”的更多相关文章

  1. 钉钉开发第三方H5微应用入门详细教程[ISV][免登流程][授权码][HTTP回调推送][识别用户身份][获取用户信息]

    转载请注明原文地址:https://www.cnblogs.com/applerosa/p/11509512.html (by lnexin@aliyun.com 世间草木) 此教程注意点: 适用于第 ...

  2. .NET平台下，钉钉微应用开发之：获取userid

    工作需求,开发钉钉微应用和小程序,之前有接触过支付宝小程序和生活号的开发,流程没有很大的差别,这里记录下我用ASP.NET MVC实现钉钉微应用的开发,并实现获取用户的userid.小弟我技术有限,本 ...

  3. 钉钉企业内部H5微应用开发

    企业内部H5微应用开发 分为 服务端API和前端API的开发,主要涉及到进入应用免登流程和JSAPI鉴权. JSAPI鉴权开发步骤: 1.创建H5微应用 登入钉钉开放平台(https://open-d ...

  4. Java钉钉开发_02_免登授权（身份验证）（附源码）

    源码已上传GitHub: https://github.com/shirayner/DingTalk_Demo 一.本节要点 1.免登授权的流程 (1)签名校验 (2)获取code,并传到后台 (3) ...

  5. 钉钉开发入门,微应用识别用户身份,获取用户免登授权码code,获取用户userid,获取用户详细信息

    最近有个需求,在钉钉内,点击微应用,获取用户身份,根据获取到的用户身份去企业内部的用户中心做校验,校验通过,相关子系统直接登陆; 就是在获取这个用户身份的时候,网上的资料七零八落的,找的人烦躁的很,所 ...

  6. Java钉钉开发_02_免登授权（身份验证）

    源码已上传GitHub: https://github.com/shirayner/DingTalk_Demo 一.本节要点 1.免登授权的流程 (1)签名校验 (2)获取code,并传到后台 (3) ...

  7. 钉钉微应用接入钉钉免登陆配置记录。NET实现

    在这里记录一下我配置的钉钉接入微应用遇到的坑.搞了我几天天才调通.头皮发麻,现在梳理一下,以免别人也入坑. 1.钉钉接入主要要获取钉钉企业员工的ID,然后去自己的应用的数据库里进行匹配然后实现免登陆的 ...

  8. Java钉钉开发_03_通讯录管理之 人员管理 和 部门管理

    一.本节要点 1.通讯录权限 ISV(应用服务商)默认无管理通讯录的权限,企业应用默认有所有通讯录权限. 2.数据传输格式—JSON 请参见: Java_数据交换_fastJSON_01_用法入门 二 ...

  9. js api 实现钉钉免登

    js api 实现钉钉免登,用于从钉钉微应用跳转到企业内部的oa,erp等,我刚刚实施完了我公司的这个功能,钉钉用起来还不错. 1 js api 实现钉钉免登,页面配置. <title>利 ...

随机推荐

  1. 日志::spdlog

    https://github.com/gabime/spdlog git clone https://github.com/gabime/spdlog.git cd spdlog && ...

  2. Https工作流程图

  3. odoo联调补充

    odoo联调补充(剑飞花 373500710) 安装某些py插件包时需要vc++2008发行包,可访问下面地址. 安装python-ldap一定要用支持9.44postgresSQL的exe安装,同样 ...

  4. 为什么阿里巴巴Java开发手册中强制要求整型包装类对象值用 equals 方法比较？

    在阅读<阿里巴巴Java开发手册>时,发现有一条关于整型包装类对象之间值比较的规约,具体内容如下: 这条建议非常值得大家关注, 而且该问题在 Java 面试中十分常见. 还需要思考以下几个 ...

  5. 百万年薪python之路 -- 变量及if的练习

    1.简述变量命名规范 1.变量由数字,字母,下划线组成 2.不能以数字开头 3.不能使用python关键字 4.不能使用中文和拼音命名 5.区分大小写 6.变量名要具有描述性 7.推荐写法 7.1驼峰 ...

  6. 推荐一款优秀的WPF开源项目

    项目介绍 此项目应用了Prism MVVM框架,项目展示数据来源于其他服务程序,使用的WebAPI通信,如果要正常运行此程序,需要您自己做一个WebAPI程序,由API接口提供数据驱动,其实直接查看代 ...

  7. Java学习笔记五--String(二)String其他方法

    第一节课 // 清除单位字符串开始和结尾空白的副本 String.trim(); 字符串每次更改都会创建新的对象,而不会覆盖原来的字符串,每次拼接都会产生新的String对象,耗时耗内存. java. ...

  8. The usage of Markdown---目录

    更新时间:2019.09.14   当我们编辑的内容比较多时,通常要生成目录来进行页内跳转.除了之前提到过的页内跳转链接的方法,还有一种方法--目录树,能够自动生产目录,大大减少工作量. tip1: ...

  9. windows下Eclipse远程连接linux hadoop远程调试 经验(一)

    环境 Windows 7 64bit JDK 1.6.0_45  (i586) JDK 1.7.0_51  (i586) Eclipse Kepler Eclipse -plugin-1.2.1.ja ...

  10. OptimalSolution(1)--递归和动态规划（1）斐波那契系列问题的递归和动态规划

    一.斐波那契数列 斐波那契数列就是:当n=0时,F(n)=0:当n=1时,F(n)=1:当n>1时,F(n) = F(n-1)+F(n-2). 根据斐波那契数列的定义,斐波那契数列为(从n=1开 ...