步骤一:创建第三方企业应用
在本部分,你需要在开发者后台创建一个第三方企业应用-H5微应用。
-
登录钉钉开发者后台。
-
在开发者后台页面,选择第三方企业应用,然后单击创建应用。
- 在弹出的创建应用页面中填写基本信息,单击确定创建。
- 应用创建完成后,在 基础信息-应用信息 页面,可以查看应用的 SuiteKey 和 SuiteSecret。
新版本开发平台,该信息统一在 基础信息-凭证与基础信息 页面
开发人员需要将这一步的 SuiteKey 和 SuiteSecret 信息替换到代码中
步骤二:设置开发管理
如果创建的是 H5 微应用,则需要先在 应用能力>添加应用能力 位置选择 其它应用能力>网页应用 进行配置,之后就可以看到 应用能力>网页应用 菜单,并进行 应用首页地址 配置
单击基础信息 >开发管理进入开发管理页面,单击修改,并根据以下内容配置开发信息。
-
服务器出口IP:输入调用钉钉服务端API时使用的IP即企业服务器的公网IP,多个IP请以英文逗号","隔开,支持带一个*号通配符的IP格式。
-
应用首页地址:输入应用首页URL,在移动端工作台点击应用图标会跳转到此页面。可输入后端服务部署的服务器的IP或域名。
步骤三:配置事件与回调
新版本页面菜单为 开发配置>事件订阅
单击 应用功能-事件与回调 进入事件回调页面,配置推送信息,详情参见第三方企业应用事件与回调流程。
-
推送方式:选择推送类型,钉钉会向应用推送订阅的回调事件,详情参见数据推送,本文选择使用SyncHTTP推送,详情参见配置SyncHTTP推送(推荐)。
-
设置对应信息。
-
生成加密Aes_key,回调消息内容的加解密参数,是AES密钥的Base64编码。
-
生成签名Token,钉钉每次向你的地址推送事件数据时都会携带token,用于生成签名、校验回调请求的合法性。必须为英文或数字,长度为3~32个字符。
-
设置回调请求地址,用于接收事件订阅请求的URL。当应用订阅的事件触发时,钉钉会向该网址发送相应的 HTTP POST 请求。
-
-
校验回调有效性。
以上部分校验回调有效性的加密方法,一定要使用官网的加密方法,否则无法校验成功,踩坑!!!
官网鉴权签名算法地址:JSAPI鉴权 - 钉钉开放平台 (dingtalk.com)
说明
接收事件回调的 URL,必须是公网可以访问的url地址,需保证URL地址所在服务可以正常访问。
测试阶段,可使用frp内网穿透测试工具,详情请参考frp内网穿透工具。
步骤四:实现免登
重要
应用自检-稳定性监控-最近7天免登用户数需要使用本项内容。
-
获取免登授权码,H5微应用免登流程。
-
调用接口获取第三方企业应用的access_token,详情参见服务商获取第三方应用授权企业的access_token。
-
调用接口获取用户的userid,详情参见通过免登码获取用户信息。
-
调用接口获取用户详情信息,详情参见查询用户详情。
步骤五:实现H5微应用JSAPI鉴权
重要
应用自检-稳定性监控-dd.config成功率需要使用本项内容。
-
稳定性审核项,如果使用应用自检-稳定性监控审核,必须实现JSAPI鉴权。
-
稳定性审核项,如果提交稳定性审核报告人工审核,则此项不需要接入。
-
下载稳定性报告模板可以在稳定性监控页面中点击人工审核进行下载。
-
审核报告填写完成后,点击人工审核进行提交。
-
第三方企业应用-H5微应用需要进行JSAPI鉴权,详情参见文档JSAPI鉴权。
步骤六:接入监控中心
说明
应用自检-功能自检-是否完成监控中心接入需要使用本项内容。
钉钉提供了应用监控平台。应用测试完成后,即可接入钉钉的监控中心进行监控,详情参见文档监控中心。
步骤七:通过体验组织授权开通
- 点击部署与发布-版本管理与发布,单击创建体验组织。
-
在开发体验账号管理页面,单击设置体验组织,依照下列要求填写后,单击确认。
-
**组织名称:**请输入组织名称。
-
**设置管理密码:**请输入管理密码。
-
- 在版本管理与发布页面,选择要授权的体验组织,单击授权。