一、前言

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

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

用户登录钉钉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. Java中package与import

    使用实例: package 一般来说,package语句必须作为源文件的第一条非注释性语句.一个java源文件只能指定一个包,即只能包含一条package语句,该源文件中可以定义多个类,则这些类将全部 ...

  2. Python编程系列---使用装饰器传参+字典实现动态路由

    # 实现一个空路由表,利用装饰器将url和功能函数的对应关系自动存到这个字典中 router_dict = {} # 定义一个装饰器 # 再给一层函数定义,用来传入一个参数,这个参数就是访问的页面地址 ...

  3. day1-02 python程序语法分析

    一.概述 程序的格式框架 命名与保留字 数据类型 语句与函数 Python程序的输入输出 二.程序的格式框架 # TempConvert.py # 输入温度 TempStr = input(" ...

  4. Activity 学习（一） 插件安装篇

    目录 Ider下安装 Eclipse下安装 Ider安装图解 首先,创建一个普通的Java工程即可,然后按照下面流程进行: 1:点击菜单中的File(最左上角),选择settings 2:plugin ...

  5. 使用诊断工具观察 Microsoft.Extensions.DependencyInjection 2.x 版本的内存占用

    目录 准备工作 大量接口与实现类的生成 elasticsearch+kibana+apm asp.net core 应用 请求与快照 Kibana 上的请求记录 请求耗时的分析 请求内存的分析 第2次 ...

  6. Java多线程编程（六）单例模式与多线程

    在使用多线程技术的单例模式时会出现一些意想不到的情况,这样的代码如果在生产环境中出现异常,有可能造成灾难性的后果. 一.立即加载/“饿汉模式” 立即加载就是使用类的时候已经将对象创建完毕,常见的实现方 ...

  7. css条件Hack属性

    <!--[if IE]> <!DOCTYPE html> <html> <head> <meta charset="utf-8" ...

  8. Alpha阶段--第七周Scrum Meeting

    任务内容 本次会议为第六周的Scrum Meeting会议 召开时间为周日下午5点,在潮音餐厅召开,召开时间约为30分钟,对已经完成项目的总结和对今后项目设计的展望 队员 任务 张孟宇 “我的”界面代 ...

  9. [springboot 开发单体web shop] 2. Mybatis Generator 生成common mapper

    Mybatis Generator tool 在我们开启一个新项目的研发后,通常要编写很多的entity/pojo/dto/mapper/dao..., 大多研发兄弟们都会抱怨,为什么我要重复写CRU ...

  10. 浅谈Retinex

    Retinex是上个世纪七十年代由Land提出的色彩理论.我认为其核心思想基于俩点 (1)在颜色感知时,人眼对局部相对光强敏感程度要优于绝对光强. (2)反射分量R(x,y)储存有无光源物体的真实模样 ...