您的位置:首页 > Web前端 > > 正文

钉钉嵌入web端应用程序(钉钉企业内部H5微应用开发详解)

更多 时间:2021-10-14 00:23:51 类别:Web前端 浏览量:2779

钉钉嵌入web端应用程序

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

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

JSAPI鉴权开发步骤:

1、创建H5微应用

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

钉钉嵌入web端应用程序(钉钉企业内部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 .
                '&timestamp=' . $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

    钉钉嵌入web端应用程序(钉钉企业内部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微应用内容请搜索开心学习网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持开心学习网!