1. 二、接入配置
2.1应用注册
参照“应用管理”注册第三方应用。
2.2应用接入
n操作说明:包括用户绑定、消息集成、待办集成、单点登录、事件绑定、菜单绑定、套件配置
图接入列表
2.2.1用户绑定
操作说明:
【绑定类型】支持点对点绑定(可以自动匹配和手工匹配),免绑定,LDAP/AD绑定。
【匹配类型】支持账号匹配、编码匹配、eMail匹配、手机号匹配
图 接入设置页面-用户绑定
图 自动匹配和手工匹配
图 用户绑定接口选择
注意:自动匹配、新建、修改需要有对应接口实现或接口库注册的接口才能使用;详细使用说明参考开发内容部分;免绑定方式可以免去每个用户必须绑定的操作,可以按登录名称,编码,邮件,手机号作为匹配依据。 | |
---|---|
2.2.2消息集成
l选择已经注册的第三方应用
l选择消息获取模式:第三方推送和第三方读取
l如果选择了第三方读取则可以设置时间间隔,启用后会定时读取消息,可以选择URL、接口模式,如果都不选择为默认内置接口模式
l第三方应用读取如果要灵活的实现,不使用URL和接口则可以自己实现代码,详情参见第三部分的开发内容
l当选择读取模式后如果按致远默认路径URI提供了接口,需要提供服务地址,详情参见第三部分的开发内容
图消息集成设置
【第三方认证】:需要选择认证接口和认证参数名称(第三方提供)
图 穿透认证为第三方认证
【读取方式】:当消息获取模式为读取时,可以选择URL、接口模式,如果都不选择为默认内置接口模式
图 第三方系统读取
注意:所设置的接口需要在第三方接口库中配置。第三方消息内置接口相关信息需要到维护中心启动参数配置。 | |
---|---|
2.2.3待办集成
待办集成同2.4.2消息集成
l选择已经注册的第三方应用
l选择消息获取模式:第三方推送和第三方读取
l如果选择了第三方读取则可以设置时间间隔,启用后会定时读取消息,可以选择URL、接口模式,如果都不选择为默认内置接口模式
l第三方应用读取如果要灵活的实现,不使用URL和接口则可以自己实现代码,详情参见第三部分的开发内容
l当选择读取模式后如果按致远默认路径URI提供了接口,需要提供服务地址,详情参见第三部分的开发内容
图 待办效果->个人设置->空间栏目->扩展栏目配置第三方待办的栏目
2.2.4单点登录
操作说明:
【认证模式】分为门户认证机制、第三方认证机制、用户密码认证、第三方Token认证机制。
【应用类型】应用系统首页(可用于配置到空间,菜单,M3)、业务操作单元、报表(仅可被报表中心选择)、其他,默认为应用系统首页。
【管理地址】当设置此地址后,会显示在CIP的【应用服务管理】二级菜单下。
【登录授权】除了内置应用,企业用车、携程商旅、formtalk、电话会议外,其他应用均需要配置授权,普通用户才能有权限。
【PC登录地址】如果是PC类型或包含PC类型的接入方式,需要填写此地址。
【H5登录地址】如果是移动URL接入类型或包含移动URL接入类型的接入方式,需要填写此地址。
【门户认证机制】SSO接口配置行会显示出来,为带认证模式。
【第三方认证机制】当目前的认证机制不能满足第三方应用接入,则可以按规范内部实现接口,登录接口会显示在配置页面。
【第三方Token认证机制】此种认证类似于OAuth认证,需要选择认证接口,接口在接口库中定义。
【用户密码认证】支持简单的用户名和密码2个参数的认证机制
【本地原生应用】只有本地原生应用类型会显示出登录命令的配置页面,支持IOS,android,Windows 命令的配置。
图 默认状态
图 门户认证机制
图第三方认证机制
图 用户密码认证
2.2.4.1第三方Token认证机制
l类似于Oauth的认证方式,详情见开发内容部分
图 第三方Token认证
2.2.4.2原生App唤醒
支持主流的app移动端类型,选择对应类型输入对应命令,例如:
sycmpiphone://m1services?serviceParams={'module':'authentication/home','username':'{$userName$}','archiveID':'-1','fromurl':'com.others.path'} |
---|
图 原生应用唤醒命令
2.2.4.3管理地址
l管理地址即第三方应用管理员单点登录地址,对应致远协同的集团管理员,单位管理员
图 配置管理地址后的效果
图第三方管理员登录流程图
协同OA返回给第三方数据:{"code": 0,"data": {"userName": "集团管理员/单位管理员","loginName": "group-admin/admin","corpName": "测试集团","telPhone": "11111111111","role": [{"roleName": "集团管理员/单位管理员","roleCode": "GroupAdmin/corpAdmin" }] },"message": ""} | |
---|---|
注意:l自定义加密算法需要符合如下:1、必须是加密类的全路径;2、类中需定义方法:encory,方法encory入参为字符串,返回类型也是字符串;l如果不配置登录授权则没有使用权限。 |
2.2.5事件绑定
n操作说明:通过内置的23个事件绑定,可以做到对应系统事件的操作来触发设置的URL或接口事件。
n【类别】:组织模型事件、新闻公告事件
图 23个事件
n操作步骤:
第一步:选择左面树形结构的一个具体事件
第二步:点击【新建绑定】后,录入对应信息
图 事件设置
【触发条件】:设置触发条件后,只有在条件满足时才会去调用设置的URL或接口,可设置为条件的内容是预制事件的参数。字符串类型的条件符号有==,包含,不包含,数字类型有>,>=,<,<=,==。
图 触发条件
【处理类型】:URL和接口,当设置URL后,事件被触发,事件参数以JSON格式调用URL;当设置接口后,事件参数仅会以接口设置的输入参数去调用。
【接口匹配】:处理类型设置为接口后,可以调用接口库中次产品下的接口,此时【事件关联数据】被激活,可选择,如图。
图 接口参数赋值
例如新增人员触发URL:{"id": "1211023486123131711","name": "张","memberLoginName": "zhangz","telNumber": "13316167890","code": "009","memberOrgDepartmentName": "部门","orgAccountName": "aa","orgPostId": "-1696775289751451665","orgPostCode": "","orgPostName": "岗位"} | |
---|---|
2.3多模态展示
2.3.1缺省模式
已配置单点登陆的应用,缺省模式下表现为PC端“门户空间”模式和M3端的应用
2.3.2应用菜单绑定
可以将第三方应用设置为协同菜单(针对PC端)
n操作说明:应用菜单仅支持配置了单点登录的注册应用,并且接入类型是PC或有PC混合类型的接入。
nPC图标需要从图标库中选择,支持自定义上传的图标。
图 新建菜单页面
图 应用选择
图 可供选择菜单的图标库
2.3.3应用套件
可以将多个有相同特征的第三方应用组合成套件在M3端使用
n操作说明:支持9个以内注册应用的选择,支持配置了单点登录并且是移动类型的接入。
图 套件设置
图 移动端显示套件效果