独立的API接口

Version 23.4.8843


独立的API接口

Version 23.4.8843


知行之桥将管理控制台(管理员在此创建和管理工作流)和公共接收端托管在同一网络端口。 为了提高安全性,需要将控制台与公共端分开,使其托管在不同的端口上。

一旦分开,连接到知行之桥公共接口的外置合作伙伴将无法访问管理控制台,即使他们获得了登录权限(默认配置在用户名/登录组合后面保护控制台)。

概述

将管理控制台与公共接口分开需要配置第二个Web应用程序,该应用程序仅由托管公共接收端所需的资源组成。 在这个额外配置完成之后,知行之桥将使用两个端口:一个用于完整的(控制台)应用程序,另一个用于仅有公共接口的应用程序。

文档中描述的标准Web配置过程介绍了配置完整的应用程序,而此页面介绍配置仅有公共端的应用程序。

限制条件

将知行之桥的控制台和公共端分开有两个要求。

  • 通过外置服务器(IIS、Jetty、Tomcat等)托管知行之桥的公共端;
  • 配置企业级数据库(MySQL、SQL Server、PostgreSQL)。

下面提供了更多细节。

.NET 版本

设置仅限公共端的应用程序

对于 Windows 安装,必须使用IIS来托管公共端。 内置Web 服务器仍可用于托管未向公众公开的完整(控制台)应用程序。

.NET 版本包括一个 www_services 文件夹,其中包含托管仅公共端的应用程序所需的 Web 配置数据。 将 IIS 定向到此文件夹将导致可通过 IIS 访问知行之桥的公共接口,而不会暴露管理控制台。 端口、SSL 等的进一步配置应直接通过 IIS 完成。

设置应用程序目录和应用程序数据库

将公共接口与控制台分离需要配置企业数据库应用程序。 “www_services”文件夹包含一个“web.config”文件,可以在其中配置应用程序目录和应用程序数据库连接。 为服务接口和管理控制台配置单独安装时,强烈建议这两种配置都指向相同的应用程序目录和数据库。 有关这些配置的详细信息,请参见配置应用程序目录和[配置应用程序数据库](Windows-Edition.html#configuring-the-application-database)。

注意www_services 文件夹与托管完整(控制台)应用程序的 www 文件夹是分开的。 www_services\web.config 文件的配置应与 www 文件夹中同名文件的配置匹配。 建议手动更新 \www_services\web.config 文件,而不是从 www 文件夹复制 web.config 文件,因为存在服务接口中不需要的与用户界面相关的 Web 配置 。

Java 版本

设置仅限公共端的应用程序

对于 Java 安装,必须使用外置 Java servlet(Jetty、Tomcat、JBoss)来托管公共接收端。 内置 Web 服务器仍可用于托管未向公众公开的完整(控制台)应用程序。

Java 版本包含一个 services.war 文件,在将公共端与控制台分离时应使用该文件。 使用外置 Java servlet 部署此 services.war 文件以创建仅限公共端的 Web 应用程序。 使用外置 Java servlet 的 XML 配置文件来完成此仅限公共端的应用程序的端口、SSL 等的进一步配置。

配置数据库

将公共接口与管理控制台分开需要配置企业数据库应用。 关于配置企业级数据库的更多细节,请参阅 这里.