钉钉授权配置说明
向日葵 | 2023-02-24
支持使用钉钉授权导入，快速同步企业成员，并可实现钉钉扫码登录，实现快速部署，大幅提升效率。
1. 在钉钉中创建自建应用
（1）前往钉钉开放平台 “应用开发-钉钉应用”页面，点击“创建应用”按钮。
（2）在创建应用页面，填写创建应用的信息，点击 <保存> 即可。
| 选项 | 说明 |
|---|---|
| 应用名称 | 自定义填写 |
| 应用描述 | 自定义填写 |
| 应用图标 | 可以选择上传应用图标，方便区分 格式要求：上传JPG/PNG格式、240X240px以上、图片大小2MB以内（点击下载样例） |
（3）点击左侧导航栏【凭证与基础信息】，在应用凭证区域，获取“Agentld”、“AppKey”和“AppSecret”。 注意： 在向日葵中绑定授权钉钉需用到“Agentld”、“AppKey”和“AppSecret”，请保存记录。
2. 配置自建应用授权
用于配置重定向URL和应用所需的权限，实现成员使用钉钉扫码登录的效果。
（1）点击左侧导航栏的【安全设置】，填入相关信息。
①服务器出口IP：114.55.179.44
②重定向URL：https://console.sunlogin.oray.com, https://cc.sunlogin.oray.com 注意： 若为私有化部署环境，请联系专属客户经理获取你的出口IP及重定向URL地址。
（2）点击左侧导航栏的【权限管理】 ，按照下图指引，批量申请权限，申请权限如下：
| 分类 | 权限 |
|---|---|
| 个人权限 | 个人手机号信息 |
| 通讯录个人信息读权限 | |
| 通讯录管理 | 企业员工手机号信息 |
| 邮箱等个人信息 | |
| 通讯录部门信息读权限 | |
| 成员信息读权限 | |
| 根据手机号姓名获取成员信息的接口访问权限 | |
| 通讯录部门成员读权限 | |
| 通讯录基本数据读权限 | |
| 通讯录数据可见范围管理权限 | |
| 通讯录组织基础信息读权限 |
3. 在向日葵中绑定授权钉钉
（1）前往钉钉开放平台，点击右上角账号，获取 Corpid 。
（2）在钉钉开放平台的【事件订阅】，获取加密 aes_key和签名 token。（若为空则自定义编辑或重置后复制） 注意： 获取加密 aes_key和签名 token后，在填写请求网址并保存之前，请勿退出当前页面。未填写请求网址离开当前页面，加密 aes_key和签名 token数据会清空。
（3）前往向日葵管理平台的【系统管理】-【第三方接入】中，选择钉钉 <接入授权> 。
（4）填入AppKey、AppSecret、Agentld、加密 aes_key、签名 token 和 Corpid ，点击【保存】，即可生成请求地址。
（5）在向日葵管理平台复制请求地址，回到钉钉管理后台【事件订阅】，将请求地址填入到【请求网址】，点击 <保存> 。
4. 添加事件，实时同步
通过事件订阅，可以满足应用及时响应钉钉事件变更的需求，如部门及人员变更时，向日葵均会自动同步信息。
（1）在钉钉管理后台【应用功能】-【事件与回调】，按照下图指引，在事件订阅处勾选添加相关事件，勾选后点击 <保存> 。
添加事件：
①通讯录用户增加
②通讯录用户更改
③通讯录用户离职
④通讯录企业部门创建
⑤通讯录企业部门修改
⑥通讯录企业部门删除
（2）完成以上操作后，在向日葵管理平台的【账号体系】-【账号管理】页面，可查看钉钉企业信息。
钉钉授权配置说明至此结束，若有疑问可联系客服进行咨询。
