钉钉配置参数说明

功能及平台机制说明

提供与钉钉第三方平台配置参数功能 从39版本开始，第三方平台参数配置都在门户的统一通用配置中设置参数，包括企业微信、钉钉、短信、邮件、双重认证、水印、门户配置等

具体操作

1. 在钉钉官网进行企业注册，具体可参考钉钉官网注册说明。
2. 进入钉钉管理后台，打开【工作台】页面，在自建应用中添加应用。
3. 进入钉钉开放平台后，首页中即可获取钉钉CorpId参数：
4. 选择企业内部开发h5微应用，点击+创建应用
5. 创建完成后，即可获取应用凭证：AgentId、AppKey、AppSecret

6. 切换到开发管理页面，对服务器出口ip及应用首页地址、pc端首页地址、管理后台地址参数可打开的平台门户应用中-系统管理-第三方平台配置-钉钉配置功能中获取。

7. 切换到权限管理页面，添加接口权限，需要添加通讯录管理、智能人事权限

8. 在钉钉开放平台移动接入应用中点击登录，获取单点登录配置参数
9. 点击创建扫码登录应用授权按钮进行创建
10. 授权页面LOGO地址，可在平台中获取logo地址
11. 回调域名，可平台门户应用中-系统管理-第三方平台配置-钉钉配置功能中获取
12. 创建完成后，在列表中可获取钉钉单点登录AppId、钉钉单点登录AppSecret参数
13. 如上配置完成后，在门户应用中的系统配置下，打开统一通用配置功能。
14. 点击添加按钮，在打开的配置项页面中，选择钉钉配置项确定
15. 打开参数设置页面，在配置项中进行参数设置
16. 钉钉配置项参数说明如下：
    1. CorpId：填写钉钉CorpId参数,必填
    2. 单点登录AppId：填写步骤8中获取到的单点配置参数，必填
    3. 单点登录AppSecret：填写步骤8中获取到的单点配置参数，必填
    4. AgentId：填写步骤5中获取的应用凭证，必填
    5. AppSecret：填写步骤5中获取的应用凭证，必填
    6. AppKey：填写步骤5中获取的应用凭证，必填
    7. 访问代理：要使用代理可开启，否则默认
    8. 代理类型：开启代理后选择代理类型
    9. 代理地址：开启代理后的代理地址
    10. 仅同步选中部门及子部门：针对门户组织自动往钉钉同步且只同步某个节点下组织情况下使用，属性值填写组织编码路径，多个组织使用逗号分隔
        1. 打开组织管理，选中要同步的组织或者子组织，勾选显示组织全路径编码
    11. 用户自动映射：新增特性，针对组织和钉钉组织各自独立不进行自动同步且不使用手工映射配置组织情况下，设置为用户ID自动映射后，只要门户的组织账号和钉钉的userID一致，即可完成自动映射(注：自动映射配置优先级高于手工映射)
    12. 是否开启模拟同步：开启模拟同步选项后，当组织进行自动同步时，在企业集成-模拟同步记录功能中可查看模拟同步信息。

免密登录报error异常以下几种问题处理

1. 如果没有在权限管理页面配置通讯录管理、智能人事权限，在门户日志中会报如下提示

2. 访问ip不在白名单之中，需要在开发管理中添加服务器出口IP，门户日志中会报如下提示

1. 新版本钉钉里登录与分享中，需要添加回调域名，打开平台门户应用中-系统管理-第三方平台配置-钉钉配置功能中获取单点登录回调URL。