目录
应用安装作为企业管理的一部分,限制了必须是管理员才有权限操作。一方面,这里严格保证了企业信息的安全可控,但同时也一定程度上导致企业运行效率的下降。企业员工需要使用某个第三方应用时,需要向管理员推荐应用,等待管理员添加,并沟通配置对应的应用可见范围,最终实现应用可用的时间周期是比较长的。
为了能让应用快速在小团队或者个人使用起来,企业微信从3.1.8版本开始,支持了员工个人授权的方式,即允许员工在没有管理员的参与下,以员工身份安装应用,用于个人使用。比如,项目管理应用可以提升个人或者小团队的效率,员工可以授权安装到个人的工作台,同时分享给其他人共同协作。目前,所有服务商都可以对接成员授权方式,而企业还处于灰度阶段,部分企业还没有下文提及的成员授权开关,我们将会逐步扩大灰度范围。
企业信息安全考虑
允许员工个人授权带来的问题是,企业如何管控这里的信息安全。这里提供了几种机制:
第一,企业可配置总开关,是否允许员工个人授权。管理员可在“应用管理—应用设置”中,进行配置。
第二,第三方应用首次被员工授权时,企业管理员会收到安装应用提醒,管理员可根据需求进行查看和管理。
第三,企业管理员可在应用详情页查看并管理第三方应用的授权方式。应用为成员授权方式时,管理员可以查看当前已授权使用的员工列表;同时也可对授权方式进行切换,将成员授权切换到管理员授权,切换后仅管理员设置的可见范围内的员工可使用该应用,之前个人授权的员工若不在可见范围内将不能继续使用。
第四,针对特定的第三方应用,支持管理员删除该应用,并同时禁用该应用被员工个人授权。管理员可在“应用管理—应用设置—应用详情页”中,进行操作。
目前以下几种场景支持成员授权应用。
注:前置条件需要满足企业开启了员工个人授权,并且该应用未被禁用员工个人授权。
下述的场景中,对于第三方应用以及行业方案都适用。
注意,如果第三方的小程序关联了多个应用,需要第三方在调用wx.qy.login时,传入suiteId参数,详情参见wx.qy.login。
针对成员授权模式,企业微信做了兼容,在企业成员授权第三方应用后,服务商可获取企业的信息(企业名称和企业ID)、已授权成员的基本信息、已授权成员的应用权限(在服务商后台创建应用时所勾选的权限)。同时,为了让成员更好地使用第三方应用,建议服务商进行以下适配:
成员授权第三方应用时,默认授权基础免费版,且成员不可以选择付费版本。当成员授权的应用满足以下任一情况时,企业微信团队会推送消息通知管理员进行付费。
成员授权的应用,仅管理员可以进行付费,付费流程同管理员授权模式下的付费流程一致。
企业微信尽可能做到两种授权模式的兼容,以在第三方服务商不做任何修改的情况下,也能平稳地为企业用户提供服务。尽管如此,我们在成员授权模式下提供了新的能力,例如第三方应用可以给不在可见范围的成员推送模板消息,这在管理员授权模式下是不允许的。所以我们建议第三方服务商关注我们的接口变更情况,包括新增与变更的接口,以提供更好的用户体验。以下是具体的变更情况。
接口 | 支持何种授权模式 |
---|---|
获取成员授权列表 | 成员授权 |
查询成员用户是否已授权 | 成员授权 |
获取选人ticket对应的用户 | 成员授权 |
接口 | 支持何种授权模式 |
---|---|
返回ticket的选人接口 | 成员授权 或 管理员授权 |
创建群聊并发送消息 | 成员授权 或 管理员授权 |
打开群聊并发送消息 | 成员授权 或 管理员授权 |
注:支持成员授权模式,是指在成员授权模式下才允许调用接口;同时支持成员与管理员授权模式,则指无论哪种授权模式下都允许调用接口。
接口 | 变更点 |
---|---|
获取永久授权码 | 新增返回字段auth_info.agent.auth_mode,表示授权模式,0为管理员授权,1为成员授权。成员授权模式下,不返回企业规模、企业所属行业、企业所属子行业。 |
获取企业授权信息 | 新增返回字段auth_info.agent.auth_mode,表示授权模式,0为管理员授权,1为成员授权。成员授权模式下,不返回企业规模、企业所属行业、企业所属子行业。 |
发送应用模板消息 | 在发送应用消息接口的基础上,第三方应用支持一种新的消息类型:模板消息;成员授权模式下,可对未授权的用户推送模板消息,查看详情 |
获取应用的管理员列表 | 成员授权模式下,不返回管理员列表 |
读取成员 | 成员授权模式下,读取成员时所属部门列表、主部门都只返回根部门id,即1;不返回部门内order |
获取部门成员 | 成员授权模式下,应用无任何部门权限,调用时将返回60011错误 |
获取部门成员详情 | 成员授权模式下,应用无任何部门权限,调用时将返回60011错误 |
获取部门列表 | 成员授权模式下,应用无任何部门权限,调用时将返回60011错误 |