跳转到主要内容
OFTP 端口通过 Odette FTP 协议发送和接收文件。

核心功能

  • 支持 Odette FTP,适用于汽车和制造业的安全文件交换
  • 支持基于证书加密、签名和压缩的双向文件传输
  • 通过 SSID/SFID 配置,实现经由中间 OFTP 实体的消息路由
  • 具备自动重试与重发逻辑,支持同步和异步回执处理

概述

OFTP 连接需要在两处配置。在 OFTP 个人设置页面中配置 Odette 标识符、本地 OFTP 服务器设置,以及所有 OFTP 连接共用的其他信息。然后为各个 OFTP 端口配置特定于单个交易伙伴(单个 OFTP 实体)的连接设置。 有关通过单独 OFTP 实体(例如清算中心)路由 OFTP 消息的信息,请参见消息路由。

个人设置配置

必须先配置 OFTP 个人设置,才能与各个 OFTP 端口建立连接。在导航栏中单击 个人设置 > OFTP。

OFTP 个人设置选项卡

个人身份标识

用于识别本地个人设置的设置。

服务器设置

与 OFTP 服务器实现相关的设置。

个人证书

与私有解密和签名证书相关的设置。

可选证书设置

用于定义证书参数的可选设置。

高级设置

锁定

与锁定服务器访问相关的可选设置。

受信任的 IP 地址

日志

用于管理日志创建和存储的设置。

设置描述
日志级别端口生成的日志的详细程度。当请求支持时,请将其设置为 Debug。
日志轮换间隔创建新日志文件之前等待的天数。
日志删除间隔删除旧日志文件之前等待的天数。

其他设置

特殊设置适用于特定用例。

设置描述
其他设置允许在以分号分隔的列表中配置隐藏的端口设置,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。

端口配置

本节包含所有可配置的端口属性。

设置选项卡

主机配置

与要连接的远程 OFTP 实体相关的设置。

连接信息

与 OFTP 连接参数相关的设置。

交易伙伴证书

与交易伙伴提供的公钥证书相关的设置。

路由

与通过单独 OFTP 实体路由 OFTP 消息相关的设置。 例如,如果端口需要将文件发送到 serverA 并通过 serverB 路由该文件,请将端口配置为连接到 serverA,并将此字段设置为配置为连接到 serverB 的 OFTP 端口。有关更多信息,请参见消息路由。

高级选项卡

可选证书(PEM/CER 格式)

与用于增强安全性的其他证书相关的设置。

首选个人设置

这些设置会覆盖个人设置页面上的 OFTP 配置。设置首选个人设置允许针对某些交易伙伴使用不同的本地证书和标识符。

TLS 客户端认证

当需要双向 TLS 身份验证时,与客户端身份验证相关的设置。

自动证书识别

本节中的字段允许你指定模式,使端口能够自动识别证书。每个字段中的默认通配符(*)会指示端口不搜索相应模式。

高级设置

先前类别中未包含的设置。

代理设置

这是一组用于识别连接所经代理并对其进行身份验证的设置。默认情况下,本节使用 安全设置 页面的 代理设置 部分中的全局设置。清除此复选框可为您的端口提供特定的设置。

设置描述
代理类型基于代理的防火墙使用的协议。
代理主机基于代理的防火墙的名称或 IP 地址。
代理端口基于代理的防火墙的 TCP 端口。
代理用户用于通过基于代理的防火墙进行身份验证的用户名。
代理密码用于对基于代理的防火墙进行身份验证的密码。
身份验证方案保留默认值 None 或选择以下身份验证方案之一:Basic、Digest、Proprietary 或 NTLM。

消息

消息设置确定端口如何搜索消息并在处理后管理它们。

设置描述
保存到已发送文件夹选中此项可将端口处理的文件复制到该端口的“已发送”文件夹中。
已发送文件夹方案端口根据选定的时间间隔对 已发送 文件夹中的文件进行分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将本周发送的所有文件存储在该文件夹中。空白设置告诉端口将所有文件直接保存在 已发送 文件夹中。对于处理许多事务的端口,使用子文件夹可以帮助保持文件有序并提高性能。

日志

用于管理日志创建和存储的设置。

设置描述
日志级别指定要记录在端口日志目录中的信息类型:
  • None - 不创建任何日志。
  • Error - 仅当端口遇到错误时才创建日志。
  • Warning - 仅当端口发出警告时才创建日志。
  • Info - 记录工作流的一般信息,包括任何错误和警告(如果适用)。
  • Debug - 记录成功和失败工作流的详细调试信息。
  • Trace - 记录成功和失败工作流的详细跟踪信息。
请注意:Debug 和 Trace 级别的日志可能会记录敏感信息,包括消息内容和 SSL 证书。尽管连接属性(例如密码)被屏蔽了,但在与您的组织外部共享它们之前,请查看此级别的日志以避免泄漏敏感信息。
日志文件夹结构指示端口根据选定的时间间隔将日志文件夹中的文件分组。例如,Weekly 选项指示端口每周创建一个新的子文件夹,并将该周的所有日志存储在该文件夹中。空白设置告诉端口将所有日志直接保存在日志文件夹中。对于处理许多事务的端口,使用子文件夹有助于保持日志的有序性并提高性能。
保留消息副本指示端口在日志目录中保存最新消息副本的切换。请注意,端口每个子文件夹只保留一个消息,并且端口在再次运行时会覆盖以前保存的消息。

其他设置

特殊设置适用于特定用例。

设置描述
其他设置允许在以分号分隔的列表中配置隐藏的端口设置,例如 setting1=value1;setting2=value2。正常的端口用例和功能不需要使用这些设置。

自动化选项卡

自动化设置

与端口自动处理文件相关的设置。

性能

与端口资源分配相关的设置。

设置描述
最大工作线程数此端口上处理文件时从线程池中消耗的最大工作线程数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。
最大文件数分配给端口的每个线程发送的最大文件数。如果设置,则会覆盖 高级设置 页面的 性能设置 部分的默认设置。

告警选项卡

SLA 选项卡

建立连接

建立传出 OFTP 连接需要以下设置:
  • 标识符(交易伙伴的标识符)
  • 密码(与交易伙伴标识符关联的密码)
  • 远程主机
  • 端口
建立连接后,必须先配置相应的交易伙伴证书,才能安全传输文件。

收发文件

完成 OFTP 个人设置和特定伙伴 OFTP 端口的配置后,即可安全地发送和接收文件。

发送文件

在 OFTP 端口中,交易选项卡会显示要发送给目标交易伙伴的文件。如果在自动化选项卡上启用了发送自动化,到达端口交易选项卡的文件会自动打包并发送。展开与已传输文件关联的行可访问所有传输的日志文件。 创建测试文件按钮可生成一系列简单的测试文件,用于发送给交易伙伴。

重发和重试

当预期交易伙伴返回异步回执,但未能在重发间隔时长内(默认 60 分钟)返回时,会触发 OFTP 重发。随后应用程序会尝试重新发送传输。应用程序会继续重发消息,直到收到回执或耗尽最大次数(异步)。 当交易伙伴系统的协议响应指示服务器未收到传输时,会触发重试。这可能表示网络或连接问题,而此类问题通常是暂时性的。应用程序会每隔重试间隔分钟重试传输,直到传输被接收或耗尽最大次数。

接收文件

在 OFTP 端口中,交易选项卡会显示应用程序已接收并路由到该端口的文件。文件会根据传入 OFTP 消息中的 Odette 标识符路由到特定 OFTP 端口。展开每个文件行可显示该传输的可用日志列表。 这些文件位于端口的交易选项卡上。如果该端口连接到工作流中的其他端口,文件会自动从 OFTP 端口的交易选项卡移动到工作流中下一个端口的交易选项卡。

消息路由

每个 OFTP 端口都配置为连接到单个 OFTP 实体。有时使用 OFTP 需要路由场景:源自某个 OFTP 实体(下图中的代理 A)的文件需要通过另一个 OFTP 实体(代理 B)才能到达目标 OFTP 实体(代理 C)。 OFTP 路由 在此场景中,代理 B 的 Odette 标识符是传输期间的 SSID 值,代理 C 的 Odette 标识符是 SFID。换句话说,SSID 标识发起方连接的“中间人”服务器,而 SFID 标识该“中间人”应将 OFTP 消息路由到的目标实体。

知行之桥 中的 OFTP 路由

若要在 知行之桥 中实现此路由场景,请配置一个 OFTP 端口连接到代理 B(“中间人”服务器),并配置另一个 OFTP 端口连接到代理 C(目标服务器)。 将代理 C 端口(设置选项卡的路由部分中)的路由伙伴字段设置为配置为连接代理 B 的 OFTP 端口。 要发送到目标服务器的文件应由配置为连接代理 C 的 OFTP 端口处理。另一个 OFTP 端口(目标为代理 B)会在后台用于路由消息,但不会直接处理工作流中的文件。

SSID 与 SFID

如果伙伴提供了一个称为 SFID 的单一标识符,请配置 OFTP 端口连接到此实体,并将该 SFID 用作 SSID。如果伙伴同时提供 SFID 值和 SSID 值,则在上述场景中,SFID 对应服务器 C,SSID 对应服务器 B。

宏

示例