提示

系统中集成的钉钉功能包括：

• 钉钉用户和部门同步
  系统支持钉钉的用户与部门同步，用户和部门信息可自动或手动同步到系统。
• 钉钉扫码登录
  用户可以通过钉钉APP扫描系统生成的二维码，实现快速登录。
• 钉钉移动端单点登录
  用户在移动端使用合同系统时，可以通过钉钉实现单点登录，无需重复认证。
• 钉钉消息推送
  系统可以将重要合同待办任务、到期提醒等信息，通过钉钉消息推送至用户。用户可以点击待办任务一键登录系统，查看合同详情并进行处理。

1、 创建应用

1.1. 打开钉钉官网：open-dev.dingtalk.com，并添加内部应用。

1.2. 获取应用的AppKey、AppSecret、AgentId、CorpId等信息，并配置到系统中。

1.3. 配置钉钉回调地址

回调地址配置为：http://ip/prod-api/third/oauth/dingtalk/callback

1.4. 接口权限配置

系统正常的使用需要依赖以下接口：用户接口、部门接口：

1.5. 设置应用地址

应用地址配置为：http://ip:180/#/pages/third/auth?corpId=$CORPID$
端口默认为180，如果您有修改，请替换为您的端口

1.6. 应用发布

2、系统中配置钉钉参数

打开服务器，修改/docker/server1/application-prod.yml文件：

justauth:
  #是否启用单点登录，设置为true表示启用
  enabled: true
  #单点登录成功地址， 前端"访问地址/sso"
  pcSSOUrl: http://localhost/sso
  #单点登录失败返回首页
  pcErrorUrl: http://localhost
  type:
    DINGTALK:
      enabled: true
      #设置为钉钉获取的AppKey
      client-id: 
      #设置为钉钉获取的AppSecret
      client-secret: 
      #登录验证地址,设置为：http://ip/prod-api/syncData/oauth/dingtalk/callback
      redirect-uri: 
  cache:
    type: default
dingMessage:
  #是否启用钉钉消息通知，设置为true表示启用
  enabled: true
  #设置为钉钉获取的agentId
  agentId: 
  #设置为钉钉获取的AppKey
  client-id: 
  #设置为钉钉获取的AppSecret
  client-secret: 
  #钉钉消息跳转的页面,第一个移动端页面,默认端口是180，如果您有修改请同步修改
  actionUrl: http://ip:180/#/pages/third/auth?corpId=$CORPID$
  #pc端单点登录地址url=http%3A%2F%2Flocalhost%2Fdev-api%2FsyncData%2Foauth%2FdingUrlLogin修改为  URLEncode后的地址:http://ip/prod-api/syncData/oauth/dingUrlLogin
  pcActionUrl: dingtalk://dingtalkclient/page/link?pc_slide=false&url=http%3A%2F%2Fip%2Fprod-api%2FsyncData%2Foauth%2FdingUrlLogin