第三方系统注册

1. 概述

1.1 版本

1.2 功能简介

为帮助系统管理员、集成开发人员快速掌握第三方系统注册的操作方法，实现与帆软、泛微 E10 等第三方系统的对接集成，特编写本教程。
外部系统调用 API 需要先在”第三方系统注册”中进行登记，以保证 API 接口在被外部系统调用时更安全。

2 前提条件

1、登录账号具备系统集成 - 第三方系统注册的操作权限；
2、已获取待整合第三方系统的基础信息（如系统类型、服务地址、公钥 / AppKey/AppSecret 等）；
3、确保网络环境可正常访问待整合的第三方系统服务端。

3 功能入口

系统管理员登录系统，执行「系统集成>第三方系统注册」菜单，如下图：

4 功能说明

4.1 第三方系统注册配置

登记第三方系统分为基础、整合至乐创者系统、整合至第三方系统三个配置标签页，按实际整合需求填写即可。

4.1.1 基础配置

输入系统名称即可，系统名称当前系统内唯一。
系统白名单：可按需进行配置，可添加多个，一旦配置，当前登记系统授权的API仅允许白名单范围内的IP才能访问。

起始IP/结束IP：支持指定IP段和IP地址。

• IP段举例：144.20.80.200~144.20.80.254，则在这个IP段范围内的IP地址（包含起始和结束地址）均可访问。
• IP地址举例：指定某个固定地址时，起始IP和结束IP需要填写一样的IP地址。

4.1.2 整合至乐创者系统（对接第三方，如帆软）

此标签页用于将第三方系统（如帆软）整合接入乐创者平台，需填写第三方系统的服务接入信息：
系统类型：从下拉菜单选择对应系统类型，支持：默认和帆软，其中“默认”是使用我们系统内置的规范去访问第三方系统；选择“帆软”时，需配置如下信息：

• 插件版本：选择适配的系统集成插件版本（如 V1.1.0）；
• 服务地址：输入第三方系统的服务访问地址（如帆软报表的访问 URL）；
• 公钥：输入第三方系统提供的接口公钥（加密校验用）；
  填写完成后，点击右下角确定，完成系统注册。

4.1.3 整合至第三方系统（对接乐创者，如泛微 E10）

此标签页用于将乐创者系统整合接入第三方平台（如泛微 E10），需填写乐创者侧的接入信息：

• 启用：开启开关，启用该整合配置；
• 系统类型：从下拉菜单选择目标第三方系统类型（如 “泛微 E10”）；
• 服务地址：输入第三方系统的服务接收地址（泛微 E10 的接口地址），选填，此处填写后，在菜单中配置菜单功能时，网页地址只需要输入相对地址即可；
• AppKey：输入第三方系统分配给乐创者的应用密钥标识；
• AppSecret：输入与 AppKey 对应的应用密钥（加密校验用）；
  填写完成后，点击确定，完成整合配置。

4.2 查看系统凭证

登记的第三方系统可通过“系统凭证”操作查看该系统的凭证信息，可用于接口认证和加密。如下图：

包括内容如下：

4.3 启用/禁用第三方系统

登记的第三方系统默认均是启用的，若系统暂时不使用，可点击“禁用”将该系统禁用，系统禁用后该系统将无法再访问授权API。