1.描述
活字格支持与钉钉集成,通过钉钉安全提供程序,活字格会从钉钉获取和缓存用户信息。在钉钉中访问活字格应用时,就会跳转到该应用,并使用钉钉账号自动登录。
2.钉钉安全提供程序
下面详细介绍如何将活字格与钉钉集成,在钉钉中访问活字格的应用的操作。
操作步骤
打开设计器,在功能区菜单栏中选择“安全->认证模式”,认证模式选择“第三方用户集成”。
图1 认证模式
发布应用。在功能区菜单栏中,选择“发布->服务器”,弹出发布设置对话框,设置完成后发布应用。
发布应用时,应用必须是英文名。
图2 发布应用
发布后,设置应用的域名。
在管理控制台,单击“应用管理->ordersystem”,进入应用设置页面,在常规设置中,设置应用的域名。
保存设置后,重启应用。
图3 设置域名
单击DingTalkSecurityProvider.zip,下载文件包。
上传安全提供程序包。在服务管理平台的“第三方”区域,单击“上传”,选择“DingTalkSecurityProvider.zip”文件。
图4 上传安全提供程序包
其他设置。上传完成后,您首先需要进行如下设置,这些参数的值需要在钉钉开放平台中获取。
图5 其他设置
- 单击https://open.dingtalk.com/,登录开发者后台。
- 登录后,选择“应用开发”下的“H5微应用”,并单击“创建应用”。
图6 H5 微应用
- 填写基本信息后配置开发信息,所有带*的为必填项。
其中:开发模式为开发应用;开发应用类型为微应用;应用首页链接为应用的域名;服务器出口为本机的IP。
填写完成后,单击“创建”。图7 创建应用
- 创建完成后,在接口权限中,开启高级权限-企业通讯录下的所有权限,并根据实际业务需要选择权限范围为全部员工或部分员工。
图8 设置接口权限
- 在应用发布中,发布应用。单击“确认发布”。
图9 发布应用
发布后,您可以设置应用的可使用范围。图10 可使用范围设置
- 在基础信息中,单击应用信息后的查看详情,将APPkey复制,粘贴到服务管理平台的Appkey中;将AppSecret复制,粘贴到Secret中。
图11 AppKey和AppSecret
- 在钉钉开放平台,选择“应用开发”下的“登录”,并单击“创建扫码登录应用授权”。
图12 创建扫码登录应用授权
弹出创建扫码登录应用授权对话框,输入名称、描述、授权LOGO地址和回调域名。
其中,回调域名为应用的域名。图13 创建扫码登录应用授权
创建完成后,您可以在扫码登录的列表中看到刚才创建的扫码登录应用授权,获取appId和appSecret粘贴到服务管理平台中。图14 获取appId和appSecret
- 至此,其他设置中的Appkey、Secret、AppId和AppSecret已全部填写完成,单击“保存设置”。
图15 其他设置
保存设置后,就会获取到钉钉的用户信息,包括用户、角色和组织结构。图16 用户信息
打开钉钉手机客户端,在工作台下,点击微应用。
图17 进入应用
钉钉会请求授权钉钉个人数据,点击“确定授权”。
图18 确定授权
授权后,就能进入活字格应用,登录用户为登录钉钉的用户名。