确认入口与接口支持
使用有权限的管理员账号进入目标组织的「管理中心」。如果「集成」中提供「OAuth 集成」,可在此登记外部客户端。配置前先查目标接口是否接受该客户端类型的访问令牌。中国版公开 REST API 指南目前演示的是 apiKey 请求头。易企办 OAuth 集成说明 · API 认证与密钥
按访问场景登记客户端
注明调用系统、负责人和用途,再选择授权模式。
用户委托。例如员工门户读取当前员工有权查看的申请。登记由门户控制的 HTTPS 回调地址,确保与请求中的地址一致。用户登录并授权后,客户端用授权码换取访问令牌。按目标环境配置 PKCE,并使用
S256。系统间访问。例如后台统计服务定期读取测试数据。由能保管凭据的服务端使用客户端凭据换取访问令牌,访问范围取决于客户端权限。
设置端点和权限并测试
将集成详情提供的客户端 ID 和令牌端点配置到外部系统。用户委托还需授权端点和已登记的回调地址。将客户端密钥保存在服务的凭据管理工具中,只授予所需资源和操作。
用户委托用不同权限的测试员工分别核对回调、令牌和只读访问。系统间访问用测试服务验证获准记录可读、范围外的资源受限。轮换前确认调用方,测试新凭据后再替换。停用测试集成后,分别检查新令牌、续期和已签发令牌在目标接口上的表现。
