跳转到主要内容

为外部系统配置 OAuth 集成

在支持 OAuth 集成的易企办组织中登记客户端,按用户委托或系统间访问配置权限,再验证实际授权范围。

确认入口与接口支持

使用有权限的管理员账号进入目标组织的「管理中心」。如果「集成」中提供「OAuth 集成」,可在此登记外部客户端。配置前先查目标接口是否接受该客户端类型的访问令牌。中国版公开 REST API 指南目前演示的是 apiKey 请求头。易企办 OAuth 集成说明 · API 认证与密钥

单个应用的后台接入可参考应用级凭据。易企办主动访问外部服务时,可在工具或流程中选择外部连接。

按访问场景登记客户端

注明调用系统、负责人和用途,再选择授权模式。

  • 用户委托。例如员工门户读取当前员工有权查看的申请。登记由门户控制的 HTTPS 回调地址,确保与请求中的地址一致。用户登录并授权后,客户端用授权码换取访问令牌。按目标环境配置 PKCE,并使用 S256。

  • 系统间访问。例如后台统计服务定期读取测试数据。由能保管凭据的服务端使用客户端凭据换取访问令牌,访问范围取决于客户端权限。

OAuth 授权示意。用户登录授权后以授权码换取令牌,后台服务以客户端凭据换取令牌。两种模式分别按获准范围访问。

设置端点和权限并测试

将集成详情提供的客户端 ID 和令牌端点配置到外部系统。用户委托还需授权端点和已登记的回调地址。将客户端密钥保存在服务的凭据管理工具中,只授予所需资源和操作。

用户委托用不同权限的测试员工分别核对回调、令牌和只读访问。系统间访问用测试服务验证获准记录可读、范围外的资源受限。轮换前确认调用方,测试新凭据后再替换。停用测试集成后,分别检查新令牌、续期和已签发令牌在目标接口上的表现。

这是否解答了您的问题?