登录钉钉开放平台
二、教程介绍
-
如何实现用户免登。免登是指用户进入应用后,无需输入钉钉用户名和密码,应用程序可自动获取当前用户身份,进而登录系统的流程。
三、准备工作
-
注册了钉钉管理员账号。若未注册,单击这里完成注册。
-
安装小程序开发者工具IDE,单击这里下载安装。
-
本教程中的示例Demo使用Java开发,确保您已经安装了Java开发环境(安装JDK)以及Java项目构建工具Maven。
四、创建和配置应用
1.登录钉钉开发者后台。
2.在应用开发页面,选择企业内部开发,然后单击创建应用。
3.填写应用的基本信息,然后单击确定创建。
-
应用类型:选择小程序。
-
应用名称:输入应用名称,长度在2-20个字符。
-
应用描述:简要描述应用提供的产品或服务,最多200个字符。
-
应用图标:上传应用图标,要求JPG/PNG格式、240*240px以上、1:1 、2MB 以内的无圆角图标。
-
开发方式:选择企业自主开发。
-
应用创建后,在应用详情页面,单击开发管理,然后单击修改完成以下配置:
-
服务器出口IP:输入调用钉钉服务端API时使用的IP即企业服务器的公网IP,多个IP请以","隔开,支持带一个*号通配符的IP格式。
本教程输入127.0.0.1。
-
(可选)PC端首页地址:输入在PC端钉钉工作台上打开本应用的地址。链接地址必须以http或https开头。
说明如果未填写,在钉钉PC端工作台点击应用图标时,会提示“电脑版暂不支持显示,请用手机钉钉扫描下方二维码查看”。只能在手机钉钉客户端使用该应用。
-
(可选)管理后台地址:输入组织管理员在钉钉管理后台访问该应用的地址。
-
单击安全中心,然后单击添加添加一个HTTP安全域名。
当小程序的前端与服务端需要进行网络通信时,需要设置安全域名。小程序前端只能通过已设置的安全域名(或IP)与服务端进行网络通信。当安全域名更新时,需要在小程序开发工具重新打包上传版本,设置的域名才会生效。
安全域名是后端服务部署的服务器的公网IP或域名,本教程输入127.0.0.1。
-
单击应用信息,获取应用的AppKey和AppSecret。
五、开发和部署后端服务
1.git地址:git clone https://github.com/opendingtalk/eapp-corp-quick-start-java.git
2.打开下载的代码工程,修改以下配置
3.打开src/main/resources/application.properties
文件,修改服务端口。
4.启动服务
5.在浏览器中访问http://localhost:8080/welcome检查服务是否启动成功。
六、开发小程序前端
1.git地址 git clone https://github.com/opendingtalk/eapp-corp-quick-start-fe.git
2.打开小程序IDE工具,然后选择已下载的小程序项目,项目类型选择钉钉 > 企业内部应用。
3.扫码登录后,关联已创建的小程序应用。
4.打开eapp-corp-quick-start-fe/page/index/index.js
文件修改应用的域名。
5.单击点击登录调试小程序,查看是否可以成功获取登录信息
6。测试需要使用到内网穿透工具,推荐使用natapp,NATAPP-内网穿透 基于ngrok的国内高速内网映射工具