北森数据连接器对接指南

2026-10-15 17:22| 发布者: 万红刚| 查看: 3| 评论: 0

摘要: 北森数据连接器对接指南1.适用范围本文说明如何在观远数据连接器中配置北森数据账户。连接器当前支持同步员工、任职、组织单元及合同协议等人力资源数据。创建账户需要北森OpenAPI连接器的Key和Secret。2.获取北森Ke ...

1. 适用范围

本文说明如何在观远数据连接器中配置北森数据账户。连接器当前支持同步员工、任职、组织单元及合同协议等人力资源数据。创建账户需要北森 OpenAPI 连接器的 Key 和 Secret。

使用有应用管理权限的账号进入北森开放平台管理后台。在“应用开发 → OpenAPI 连接器”中创建或选择用于观远数据接入的连接器，打开连接器详情，查看 Key 和 Secret。若看不到连接器或凭证，请联系企业的北森管理员确认权限。

以下是公开资料中的北森后台脱敏示例，仅用于定位菜单和字段；实际页面以当前北森后台为准。

先在“应用开发 → OpenAPI 连接器”的列表中，找到对应连接器并点击右侧“查看详情”。

北森后台应用开发页，左侧 OpenAPI 连接器菜单和列表中的查看详情位置

进入详情后，在页面上方查看 Key 和 Secret，二者位于同一区域。下面的大图同时保留了顶部“应用开发”和凭证区域的位置。

北森 OpenAPI 连接器详情页概览，显示顶部应用开发导航和下方 Key、Secret 位置

在北森后台复制同一个 OpenAPI 连接器的 Key 和 Secret。Secret 属于敏感凭证，请勿放入公开截图、聊天消息或文档。获取入口为北森开放平台管理后台。

北森字段	获取位置	用途
Key	OpenAPI 连接器详情；打开北森管理后台	填写观远连接器的“应用 Key（key）”。
Secret	与 Key 相同的 OpenAPI 连接器详情；打开北森管理后台	填写观远连接器的“应用密钥（secret）”。

需要读取员工、组织或合同等数据时，还应由北森管理员检查该 OpenAPI 连接器是否已配置相应接口权限及受信 IP。具体权限以实际要同步的接口为准。

在观远数据连接器的数据账户管理中点击“新增数据账户”，选择“北森”。

观远数据连接器北森数据账户表单，包含应用 Key 和应用密钥

北森信息	连接器字段	是否必填	说明
自定义名称	账户名称	是	用于在观远连接器中识别此账户。
OpenAPI 连接器 Key	应用 Key（key）	是	复制北森连接器详情中的 Key。前往北森管理后台获取。
同一连接器的 Secret	应用密钥（secret）	是	复制与上述 Key 配套的 Secret。前往北森管理后台获取。

问题	处理建议
找不到 Key 或 Secret	使用有权限的账号进入北森管理后台，查看“应用开发 → OpenAPI 连接器”的详情；如无访问权限，联系企业北森管理员。
测试连接失败	核对 Key 和 Secret 是否来自同一连接器，并检查该连接器的接口权限及受信 IP。