创建连接器

操作视频

本视频介绍如何通过导入API中心的API资产创建连接器，演示通过导入API中心的OpenAPI文件创建连接器的操作。

从空白开始创建

1. 在开天集成工作台界面中，选择左侧导航栏中的“连接器 > 我的连接器”，在界面右上方选择“创建我的连接器”。
2. 设置连接器基本信息，具体的参数说明如表1所示。

   表1 参数说明

   参数	说明
   连接器名称	填写连接器的名称，根据规划自定义。建议您按照一定的命名规则填写连接器名称，方便您快速识别和查找。同一租户下的连接器不能重名。
   描述	连接器的描述信息，该描述将显示在连接器的详情中，帮助用户了解连接器。
   图标	支持自定义图标或选择系统图标。 自定义图标要求为：格式为png、jpg，大小≦1MB。
   协议	选择被调用API的传输协议，支持http或https。
   主机地址	填写被调用API的主机地址。根据实际需求开启支持主机地址修改开关，开启后，可以在有连接的地方修改被访问的主机地址。 ：表示不支持主机地址的修改。 ：表示支持主机地址的修改。
   基准URL	被调用API的Base URL，即域名的根路径。
   边缘节点	可选参数。边缘节点充当桥梁，通过使用边缘节点可以在云服务中连接边缘应用，具体请参见边缘节点。
   验证方式	根据被调用API的认证方式，选择并配置连接器的安全认证方式。 基本认证：用户在创建连接时提供有效的用户名（Username）和密码（Password）即可，此处无需定义。 API key：用户在使用连接器前需提供API密钥所需的字段，以及该验证所必须的字段值。 OAuth 2.0：使用Oauth 2.0身份验证框架对服务进行身份验证。 在使用此身份验证类型之前，需要向服务注册应用程序，以便它可以接收用户的访问Token。 IAM：该认证用于通过用户名/密码的方式来获取IAM用户的Token。 AK/SK：使用访问密钥ID（Ak，Access Key ID）和密钥（Sk，Secret Access Key）对请求进行签名，在请求时将签名信息添加到消息头，从而通过身份验证。用户在创建连接时输入值即可，此处无需定义。APIG的App认证则需提供AppKey以及AppSecret。 自定义：自定义用户在创建连接时的身份验证方式。 说明： 使用自定义认证时，如果选择使用函数，函数支持缓存时间，在这个缓存时间内，不再调用这个函数，直接使用这个缓存的调用结果。选择使用函数时，您可以进行以下操作： 单击：可以直接在弹出的“创建函数”页面快速创建函数，参数配置完成后可单击“创建”保存函数。 单击：选择函数后，单击该图标可以在弹出的“编辑函数”页面中快速编辑函数，参数编辑完成后可单击“更新”保存函数。 单击：创建或编辑函数后，单击该图标，可刷新“选择函数名称”下拉列表中的函数列表。 单击：选择函数后，单击该图标可快速复制函数。 无验证：用户不需要任何身份验证即可创建与连接器的连接。无验证时，任何用户都可以使用您的连接器。 行业模板：行业模板认证方式是将常见的ERP软件的认证方式内置在系统中，例如SAP Business One、钉钉等ERP系统，他们本身的认证需要使用自定义函数的方式来获取认证鉴权。为了减少客户负担，增加行业模板认证，用户不需要再写函数代码，只需要配置即可完成认证。 用户可以选择系统内置行业模板作为连接器的验证方式。支持SAP Business One、钉钉。行业模板的详细信息请参考行业模板介绍。

3. 设置完成后，单击“创建”。

   连接器基本信息创建成功后，系统跳转至连接器详情页面。连接器显示在“连接器 > 我的连接器”页面的列表中。

   连接器“状态”为“不可用”。

   连接器需要创建触发事件/执行动作、发布、创建连接后，才能正常使用，具体请参见创建触发事件、创建执行动作、发布连接器、连接管理。

   一个连接器至少包含一个触发事件或执行动作。

导入OpenAPI文件创建

1. 在开天集成工作台界面中，选择左侧导航栏中的“连接器 > 我的连接器”，在界面右上方选择“导入OpenAPI文件创建”。
2. 在弹出的界面中，选择导入方式 。
   • 如果导入方式选择“本地文件”，操作步骤如下：
     1. 单击“添加文件”，选中准备好的OpenAPI文件。
     2. 单击“确定”。
        

        支持上传.json格式的文件，单个文件不能超过1MB，只能上传一个文件。

   • 如果导入方式选择“API资产”，操作步骤如下：
     1. 选择API文件。
     2. 资产来源选择“所有来源”或“APIHub”，资产类型选择“公共资产”或者“租户资产”。也可以输入资产名称查询相关的API资产。
     3. 选择所需要的资产名称，单击“确定”。

   创建成功后，连接器“状态”为“待发布”。

   连接器发布后，才能正常使用，具体请参见发布连接器。

从APIExplorer导入创建

1. 在开天集成工作台界面中，选择左侧导航栏中的“连接器 > 我的连接器”，在界面右上方选择“从ApiExporer导入创建”。
2. 在弹出界面，填写连接器的信息，请参考表2。

   表2 参数说明

   参数	说明
   名称	选择了“产品服务”后，自动显示，也可以自定义填写连接器的名称。建议您按照一定的命名规则填写连接器名称，方便您快速识别和查找。同一租户下的连接器不能重名。
   图标	支持自定义图标或选择系统图标。 自定义图标要求为：格式为png、jpg，大小≦1MB。
   行业分类	在下拉框中选择API所属行业分类。
   产品服务	选择“行业分类”后，在下拉框中选择API所属的服务。
   选择Regin	选择API后，在下拉框中选择API所属区域。
   选择API	选择需要的API。 在“所属模块”右侧，选择API所属模块。 勾选需要导入的API，单击。

3. 配置完成后，单击“确定”。

   创建成功后，系统跳转至连接器详情页面，检查连接器的触发事件或执行动作。连接器显示在“连接器 > 我的连接器”页面的列表中。

   连接器“状态”为“待发布”。

   连接器发布后，才能正常使用，具体请参见发布连接器。

更多操作

连接器创建完成后，您可以执行如表3的操作。