连接钉钉和企业微信

云帆考试系统提供了方便的方式进行快速连接到钉钉或者企业微信中,企业用户只需要在钉钉控制台或企业微信工作台直接点击应用即可进入并登录到考试系统中(兼容手机端)。

钉钉PC端:

企业微信PC端:

连接钉钉

进入钉钉管理后台

从控制台或下面的链接进入管理中心:
https://login.dingtalk.com/oauth2/challenge.htm?redirect_uri=https%3A%2F%2Foa.dingtalk.com%2Fomp%2Flogin%2Fdingtalk_sso_call_back%3Fcontinue%3Dhttps%253A%252F%252Foa.dingtalk.com%252F%253Fspm%253Da213l2.13146415.4929779444.109.7f1571666zKSkW&response_type=code&client_id=dingoaltcsv4vlgoefhpec&scope=openid+corpid&org_type=management open in new window

添加应用

位置:工作台—>应用管理:自建应用

进入钉钉开放平台:应用开发—>企业内部开发

应用类型:H5微应用
应用图标:自行设置,出现在工作台的应用图标

创建成功后,会跳到应用基础信息,如下:

注意:以上AppKey / AppSecret为应用的标识信息,在接下来需要配置到考试系统中

开发管理

基础信息—>开发管理: 修改

说明:
1、应用首页地址:部署好的系统地址,格式如:https://您的域名或IP端口/api/connect/ding
2、PC端首页地址:与应用首页地址一致即可
3、管理后台地址:可不填或填写考试系统地址

权限管理

配置应用能获取成员的哪些信息、主要用于同步登录 权限范围:哪些员工可以看到这个应用 权限接口:请授予应用以下权限

登录与分享

说明:添加系统首页域名或IP作为回调域名即可,如:https://exam.yfhl.net

版本管理与发布

发布后对应的用户和组能看到此应用

配置考试系统

在上一步得到的AppKey / AppSecret配置到考试系统配置文件(application-loca.yml)中,配置好则为如下样式:

# 钉钉
ding-talk:
  login:
    app-key: dingq10lqjp9s50lzdup
    app-secret: 1ei-y1u7_0EHT8pDWjXZ3zEXrsaZ-hC4QFd6dxHtZXAi5B2KvhJB9DdQoh8ewhKg
    redirect: https://yourdomain.com/api/common/ding-talk/redirect

注意:redirect格式为https://您的域名或IP/api/common/ding-talk/redirect
如:https://exam.yfhl.net/api/common/ding-talk/redirect

接入企业微信

进入企业微信管理后台

在工作台点击用户头像—>管理企业进入或使用以下链接进入企业微信管理后台: https://work.weixin.qq.com/wework_admin/loginpage_wx?redirect_uri=https%3A%2F%2Fwork.weixin.qq.com%2Fwework_admin%2Fframeopen in new window

添加应用

应用管理—>应用:创建应用 可见范围/成员:选择哪些成员可以看到这个应用,如果是测试,建议把所有部门或成员勾选上,避免添加了看不到应用的问题

设置应用主页

选择类型为网页,网页格式为:https://您的域名或IP/api/connect/cwx
如:https://exam.yfhl.net/api/connect/cwx

网页授权及JS-SDK

位置:开发设置—>网页授权及JS-SDK:设置可信域名
可信域名:都填写考试系统域名,不需要带http或https,如:exam.yfhl.net

配置可信域名需完成域名归属认证:

1、下载txt文件到本地
2、上传此txt文件到服务器上,如考试系统已经部署好,可以将此文件放入PC前端页面的根目录下面,如:/data/run/dist/WW_verify_PKfZ4aYSJmttpSgc.txt
3、放置好以后,确保可以正常访问到这个txt文件即可

企业微信授权登录

位置:开发设置—>企业微信授权登录:设置
授权回调域:填写考试系统域名,不带http或https,如:exam.yfhl.net 注意:千万不要误勾选这个,勾选后无法在控制台看到应用图标

配置考试系统

# 企业微信
crop-wechat:
  login:
    crop-id:
    agent-id:
    crop-secret:
    redirect: https://yourdomain.com/api/common/crop-wechat/redirect

如上,配置文件需要crop-id/ agent-id / crop-secret三个参数,通过以下方式获得这些参数

获取crop-id

位置:管理后台—>我的企业—>企业ID

获取agent-id

获取crop-secret

为了安全起见,Secret不能在网页上查看,点击发送按钮,在手机版本中打开企业微信,会收到一条推送信息,打开即可看到!

全部配置好的信息如下:


# 企业微信
crop-wechat:
  login:
    crop-id: wxf2e5fcb833d495f2
    agent-id: 1000016
    crop-secret: lO4XemiJMF_Vbf4ci5Y1a6lptkHITVAc0uxGOOJF3oM
    redirect: https://yourdomain.com/api/common/crop-wechat/redirect

注意:redirect格式为https://您的域名或IP/api/common/crop-wechat/redirect 如:https://exam.yfhl.net/api/common/crop-wechat/redirect