企培版 - 钉钉自建应用设置
本文档指导您在钉钉开放平台创建企业内部应用,并完成与课程平台的登录对接配置。
👉 传送门:钉钉开放平台
创建自建应用
- 访问钉钉开放平台,使用钉钉管理员账号扫码登录。
- 在左侧导航栏选择 应用开发 > 企业内部应用 > 钉钉应用 ,点击 创建应用
- 填写相关信息,完成应用的基础创建。
获取应用信息
(1) 在应用详情页左侧导航栏,点击 凭证与基础信息 ,可以获取如下参数:
- AgentId
- Client ID
- Client Secret
(2) 在顶部导航用户头像下方,可以获取 CorpId 参数。
(3) 将相关参数填写到课程平台对应的钉钉配置项中。
添加应用能力
在应用详情页,点击左侧 应用能力 → 添加应用能力,选择 网页应用
在配置页中,分别填写 桌面端主页 和 移动端主页 的 URL
桌面端主页 :用户从 PC 端工作台点击应用时打开的地址,配置如下:
https://{your-domain.com}/sso/dingtalk
移动端主页 :用户从移动端工作台点击应用时打开的地址,配置如下:
https://{your-domain.com}/h5/#/pages/sso/dingtalk
注意: 请将 {your-domain.com} 替换成自己的域名。
安全配置
在左侧导航栏选择 安全设置 ,填写 重定向URL
需要添加的重定向地址如下:
- https://{your-domain.com}/oauth/dingtalk/callback
权限配置
为了让课程平台能够获取钉钉部门和用户的基本信息,需要申请对应权限。
左侧导航栏点击 权限管理, 搜索并开通以下常用权限 :
| 权限名称 | 权限代码 |
|---|---|
| 企业员工手机号信息 | fieldMobile |
| 邮箱等个人信息 | fieldEmail |
| 通讯录个人信息读权限 | Contact.User.Read |
| 通讯录部门信息读权限 | qyapi_get_department_list |
| 通讯录部门成员读权限 | qyapi_get_department_member |
| 成员信息读权限 | qyapi_get_member |
| 根据手机号获取成员基本信息权限 | qyapi_get_member_by_mobile |
| 获取钉钉开放接口用户访问凭证的基础权限 | open_app_api_base |
| 企业内机器人发消息权限 | qyapi_robot_sendmsg |
版本管理与发布
应用需要发布后才能在钉钉工作台内正式使用。
- 左侧导航栏点击 版本管理与发布
- 点击 创建版本 ,填写相关信息。
- 点击 保存 ,然后点击 申请发布
本文系原创,转载请注明出处
评论已关闭