钉钉企业内部H5微应用开发详解


Posted in HTML / CSS onMay 12, 2020

企业内部H5微应用开发 分为 服务端API和前端API的开发,主要涉及到进入应用免登流程和JSAPI鉴权。

JSAPI鉴权开发步骤:

1、创建H5微应用

登入钉钉开放平台(https://open-dev.dingtalk.com/),进入“应用开发”->企业内部开发H5微应用->创建应用,并填写基本信息和配置开发信息

钉钉企业内部H5微应用开发详解

2、JSAPI鉴权服务端API的开发:

(1)通过appKey 和 appSecret 获取调用接口凭证AccessToken(https://oapi.dingtalk.com/gettoken?appkey=appKey&appsecret=appSecret)

(2)通过AccessToken 获取用于JSAPI的临时票据Ticket(https://oapi.dingtalk.com/get_jsapi_ticket?access_token=ACCESS_TOKEN)

(3)ticket(JSAPI的临时票据),nonceStr(随机串),timeStamp(时间戳),url(当前网页的URL,不包含#及其后面部分)计算签名信息

计算签名参数

/*
     *ticket(JSAPI的临时票据),nonceStr(随机串),timeStamp(时间戳),url(当前网页的URL,不包含#及其后面部分)计算签名信息
     * */
    public static function sign($ticket, $nonceStr, $timeStamp, $url)
    {
        $plain = 'jsapi_ticket=' . $ticket .
            '&noncestr=' . $nonceStr .
            '×tamp=' . $timeStamp .
            '&url=' . $url;
        return sha1($plain);
    }

(4)通过AccessToken 获取用于JSAPI的临时票据Ticket(说明:由于会牵涉到多个企业,企业的appKey 和 appSecret的一些信息都是写在JSON配置文件中,前端传企业ID到服务端,服务端就会从JSON配置文件中获取企业信息)

/*
     * 根据企业ID corpid 返回 JSAPI 鉴权配置信息
     * */
    public static function getConfig($corpid)
    {
        $_config = self::getApiConfig($corpid);
        $appkey = $_config["AppKey"];
        $appsecret = $_config["AppSecret"];
        $agentid = $_config["AgentId"];
        $nonceStr = 'flywong';
        $timeStamp = time();
        //$url = self::getCurrentUrl();
        $url = $_config["AppUrl"];
        
        $accessToken = self::getAccessToken($appkey,$appsecret);
        $ticket = self::getTicket($accessToken);
        $signature = self::sign($ticket, $nonceStr, $timeStamp, $url);
        
        $config = array(
            'agentId' => $agentid,
            'corpId' => $corpid,
            'timeStamp' => $timeStamp,
            'nonceStr' => $nonceStr,
            'signature' => $signature,
            'url' => $url,
            'type'=>0
        );
        return json_encode($config, JSON_UNESCAPED_SLASHES);
    }
/*
     * 根据企业ID corpid 从api_config.json配置文件中找到 企业对应的信息,并返回企业应用开发信息
     * */
    public static function getApiConfig($corpid)
    {
         $json_string = file_get_contents(__DIR__ .'/../api_config.json');   //从文件中读取数据到PHP变量
         $arrs = json_decode($json_string, true); 
         foreach($arrs as $key => $value)
         {
             if($value["CorpId"] == $corpid)
             {
                 return $value;
             }
         }
    }

企业的配置文件api_config.json

钉钉企业内部H5微应用开发详解

3、JSAPI鉴权前端API的开发:

前端发送GET请求获取服务端的JSAPI 鉴权配置信息

// 异步获取dd.config
  async getDDConfig({commit, state},callback) {
    // 发送异步ajax请求
    const result = await reqDDConfig(state.CorpId)
    // 提交一个mutation
    const ddconfig = result
    ddconfig.jsApiList= state.jsApiList 
dd.config(ddconfig); 

commit(RECEIVE_DDCONFIG, {ddconfig}) 


// 数据更新了, 通知一下组件 

callback && callback() 
}
let that = this;
      //获取 JSAPI 鉴权配置信息
      that.$store.dispatch('getDDConfig', () => {//
        that.$nextTick(() => {// 数据ddconfig state 更新后执行
          that.$store.dispatch('getUserinfo')//获取登入用户信息
          that.$store.dispatch('getGeolocation')//获取地图定位信息
        })
      })
/* 状态管理*/
export default {
  CorpId:'dingb0bd5c5a3ba53e1231232378f',//企业ID
  ddconfig:{},//钉钉签权配置信息
  jsApiList:[
    'runtime.info',
    'biz.contact.choose',
    'device.notification.confirm',
    'device.notification.alert',
    'device.notification.prompt',
    'biz.ding.post',
    'biz.util.openLink',
    'device.geolocation.get',
    'biz.util.scanCard'
  ],//需要签权的JSAPI
  userinfo:{}, //用户信息
  geolocation:{} //地图定位信息
}

4、H5微应用的免登

“免登”是指用户进入应用后,无需输入钉钉用户名和密码,应用程序可自动获取当前用户身份,进而登录系统的流程。

1、前端去获取微应用免登授权码,然后把授权码发送到服务端api得到当前用户信息

// 异步获取userinfo
  getUserinfo({commit, state}) {
    dd.runtime.permission.requestAuthCode({
      corpId: state.CorpId, // 企业id
      onSuccess: async function (info) {
        let code = info.code // 通过该免登授权码可以获取用户身份
        // 发送异步ajax请求
        const result = await reqUserinfo(code,state.CorpId)
        // 提交一个mutation
        const userinfo = result
        commit(RECEIVE_USERINFO, {userinfo})
      }
    })
  }

2、服务端API获取用户信息

/*
     * 通过免登授权码code和access_token获取用户的userid
     * */
    public static function getUserInfo($accessToken, $code)
    {
        $response = \util\Http::get("/user/getuserinfo",array("access_token" => $accessToken, "code" => $code));
        $userinfo = json_decode(json_encode($response),true);
        $userid = $userinfo["userid"];
        return self::getuser($accessToken,$userid);
    }
    /*
     * 通过access_token 和 userid 获取用户详情
     * */
    private static function getuser($accessToken,$userid)
    {
        $response = \util\Http::get("/user/get",array("access_token" => $accessToken, "userid" => $userid));
        return json_encode($response);
    }

提醒:钉钉的信息获取必须在钉钉应用环境中运行。(我是在电脑上安装安卓模拟器然后安装钉钉APP进行调试的)

到此这篇关于钉钉企业内部H5微应用开发详解的文章就介绍到这了,更多相关钉钉企业内部H5微应用内容请搜索三水点靠木以前的文章或继续浏览下面的相关文章,希望大家以后多多支持三水点靠木!

HTML / CSS 相关文章推荐
CSS3 网页下拉菜单代码解释 中文翻译
Feb 27 HTML / CSS
CSS类名支持中文命名的示例
Apr 04 HTML / CSS
HTML5标签小集
Aug 02 HTML / CSS
关于HTML5的22个初级技巧(图文教程)
Jun 21 HTML / CSS
html5 Canvas画图教程(6)—canvas里画曲线之arcTo方法
Jan 09 HTML / CSS
html5读取本地文件示例代码
Apr 22 HTML / CSS
HTML5全屏(Fullscreen)API详细介绍
Apr 24 HTML / CSS
基于HTML5代码实现折叠菜单附源码下载
Nov 27 HTML / CSS
HTML5 画布canvas使用方法
Mar 18 HTML / CSS
浅谈HTML5 服务器推送事件(Server-sent Events)
Aug 01 HTML / CSS
iphoneX 适配客户端H5页面的方法教程
Dec 08 HTML / CSS
canvas进阶之贝塞尔公式推导与物体跟随复杂曲线的轨迹运动
Jan 10 HTML / CSS
html5 横向滑动导航栏的方法示例
May 08 #HTML / CSS
HTML5触摸事件(touchstart、touchmove和touchend)的实现
May 08 #HTML / CSS
HTML5 body设置自适应全屏
May 07 #HTML / CSS
iframe与window.onload如何使用详解
May 07 #HTML / CSS
HTML5录音实践总结(Preact)
May 07 #HTML / CSS
详解HTML5.2版本带来的修改
May 06 #HTML / CSS
canvas绘制太极图的实现示例
Apr 29 #HTML / CSS
You might like
Laravel实现自定义错误输出内容的方法
2016/10/10 PHP
php如何计算两坐标点之间的距离
2018/12/29 PHP
JS 自动安装exe程序
2008/11/30 Javascript
javascript 变量作用域 代码分析
2009/06/26 Javascript
JQuery 操作Javascript对象和数组的工具函数小结
2010/01/22 Javascript
js中的屏蔽的使用示例
2013/07/30 Javascript
Javascript中查找不以XX字符结尾的单词示例代码
2013/10/15 Javascript
JS小功能(button选择颜色)简单实例
2013/11/29 Javascript
Bootstrap中定制LESS-颜色及导航条(推荐)
2016/11/21 Javascript
利用Plupload.js解决大文件上传问题, 带进度条和背景遮罩层
2017/03/15 Javascript
jquery实现提示语淡入效果
2017/05/05 jQuery
JS实现unicode和UTF-8之间的互相转换互转
2017/07/05 Javascript
关于Angularjs中跨域设置白名单问题
2018/04/17 Javascript
vue加载完成后的回调函数方法
2018/09/07 Javascript
JS大坑之19位数的Number型精度丢失问题详解
2019/04/22 Javascript
nodejs中使用archive压缩文件的实现代码
2019/11/26 NodeJs
file-loader打包图片文件时路径错误输出为[object-module]的解决方法
2020/01/03 Javascript
vue-cli 关闭热更新操作
2020/09/18 Javascript
js操作两个json数组合并、去重,以及删除某一项元素
2020/09/22 Javascript
linux系统使用python监控apache服务器进程脚本分享
2014/01/15 Python
Python装饰器decorator用法实例
2014/11/10 Python
Linux下为不同版本python安装第三方库
2016/08/31 Python
Python实现的将文件每一列写入列表功能示例【测试可用】
2018/03/19 Python
pandas 数据结构之Series的使用方法
2019/06/21 Python
详解PyCharm安装MicroPython插件的教程
2019/06/24 Python
python通过http下载文件的方法详解
2019/07/26 Python
flask利用flask-wtf验证上传的文件的方法
2020/01/17 Python
python3.4中清屏的处理方法
2020/07/06 Python
Python 使用xlwt模块将多行多列数据循环写入excel文档的操作
2020/11/10 Python
python3 通过 pybind11 使用Eigen加速代码的步骤详解
2020/12/07 Python
css和css3弹性盒模型实现元素宽度(高度)自适应
2019/05/15 HTML / CSS
如何用Lucene索引数据库
2016/02/23 面试题
大学生求职自荐信
2013/12/12 职场文书
学生顶撞老师的检讨书
2014/09/17 职场文书
开展批评与自我批评发言材料
2014/10/17 职场文书
自主招生自荐信怎么写
2015/03/24 职场文书