SFTP快速开始


SFTP连接器简单易用,只需要下面两个步骤即可完成系统配置,实现数据传输。

  1. 配置新服务器
  2. 上传&下载文件

配置新服务器


初次运行程序时,SFTP Port会显示About页面,点击“Activate 30-Day Trial”激活30天试用版以供测试使用。

首先,请点击“PORTS”菜单项,选择PORTS页面左侧边栏中“齿轮样式图标”新增SFTP Port/交易伙伴,此测试示例中交易伙伴Port Id为“TestSFTP”。

通常情况下,SFTP服务器支持三种认证方式:密码认证方式、公钥认证方式以及多重认证方式(密码认证&公钥认证)。



密码认证方式

服务器的许多设置项都是可选的,特别是在“Advanced”标签页下的项。若采用密码认证方式,以下配置项是必填的:

  • Port Id(服务器名称)
  • Remote Host(服务器地址)
  • Remote Port(服务器端口)
  • Authentication Mode(客户端认证方式)
  • User(用户名)
  • Password(用户登录密码)
  • Server Public Certificate(服务器公钥证书)

1)Port Id(服务器名称):由于交易伙伴SFTP服务器名称可能会难以区分,在这个配置项下您可以自定义各交易伙伴的Port Id值,以便于区别各个交易伙伴。

2)Remote Host(服务器地址):SFTP服务器用来接收数据的IP地址/主机地址,每位交易伙伴须拥有唯一的SFTP服务器地址(由交易伙伴提供)。

3)Remote Port(服务器端口):SFTP服务器的端口地址(由交易伙伴提供)。

4)Authentication Mode(客户端认证方式):此例认证方式为“Password”(密码认证方式)。

5)User(用户名):您用来登录交易伙伴SFTP服务器的用户名(由交易伙伴分配)。

6)Password(用户登录密码):您用来登录交易伙伴SFTP服务器的密码(由交易伙伴分配)。

7)Server Public Certificate(服务器公钥证书):用来验证交易伙伴SFTP服务器的公钥证书(由交易伙伴提供)。更多

  • 在测试过程中,可以将证书设置为“Any Certificate”,连接器即可以接收所有的证书。注意,请勿在正式环境中设置为“Any Certificate”,否则将会出现安全性问题。



公钥认证方式

如下是公钥证书认证必须的配置:

  • Port Id(服务器名称)
  • Remote Host(服务器地址)
  • Remote Port(服务器端口)
  • Authentication Mode(客户端认证方式)
  • Client Certificate (客户端私钥证书文件)
  • Certificate Password (客户端私钥证书密码)
  • Server Public Certificate(服务器公钥证书)

1)Port Id(服务器名称):由于交易伙伴SFTP服务器名称可能会难以区分,在这个配置项下您可以自定义各交易伙伴的Port Id值,以便于区别各个交易伙伴。

2)Remote Host(服务器地址):SFTP服务器用来接收数据的IP地址/主机地址,每位交易伙伴须拥有唯一的SFTP服务器地址。

3)Remote Port(服务器端口):SFTP服务器的端口地址。

4)Authentication Mode(客户端认证方式):认证模式为“Public Key”(公钥认证方式)。

5)Client Certificate(客户端私钥证书文件):使用公钥认证方式,此处需要配置您的私钥证书文件。

6)Certificate Password(客户端私钥证书密码):您的私钥证书文件密码。

7)Server Public Certificate(服务器公钥证书):用来认证服务器的公钥证书。更多

  • 在测试过程中,可以将证书设置为“Any Certificate”,连接器即可以接收所有的证书。注意,请勿在正式环境中设置为“Any Certificate”,否则将会出现安全性问题。



多重认证方式

多重认证方式将会同时使用密码和公钥认证方式用来连接SFTP服务器。因此下面的这些设置都是必须的:

  • Port Id(服务器名称)
  • Remote Host(服务器地址)
  • Remote Port(服务器端口)
  • Authentication Mode(客户端认证方式)
  • User 用户名
  • Password 用户登录密码
  • Client Certificate (客户端私钥证书文件)
  • Certificate Password (客户端私钥证书密码)
  • Server Public Certificate(服务器公钥证书)

上传& 下载文件

完成系统配置,即可使用SFTP Port通过互联网收发文件。每位已配置好的交易伙伴都有一个 SendReceive 标签页,用以显示上传和下载的文件。


下载文件
每位交易伙伴Port的Receive页面会显示您从交易伙伴SFTP Server下载的所有文件。


上传文件
您可以在这个标签页面上传文件给已有的交易伙伴,请将需要上传的文件放置在此交易伙伴SFTP Port目录下的Send目录中。当手动上传成功后,您可以配置应用程序使其自动上传Send目录中的所有文件。当您初次配置交易伙伴资料时,可通过以下步骤检验数据传输是否成功。更多

  • 点击“Create Test Files”选项,系统会自动创建数个测试文件。
  • 择测试文件左侧的复选框,勾选需要上传的测试文件,点击“Send”按钮即可上传测试文件至交易伙伴SFTP服务器。


文件传输日志
成功上传文件至交易伙伴Server后,您可以在当前页面的文件列表上方看到传输状态。如果文件传输成功,可以看到绿色的成功状态消息,反之,会看到红色的包含详细原因的错误消息。同时,文件列表也会被更新并包含最新的传输日志内容。更多

  • 点击“+”加号图标,展开已上传文件行可以看到最新的传输日志详情。


上传和下载的文件是单独运行的,您需要确认上传和下载文件都可以成功运行。

  • 点击“+”加号图标,展开已下载的文件行可以查看和该文件相关的传输日志详情。
  • 如果您点击日志文件链接,即可直接下载。

关于Automation Settings

为了应对数据自动上传过程中出现的错误,您可以在交易伙伴Port -> Settings -> Automation Settings下设置上传重试设置,使得应用程序在无用户干预的情况下应对传输错误。

  • 若勾选“Upload files placed in the send directory to the remote path specified above”,系统会自动上传send目录下文件至以上指定的交易伙伴Remote Path。
  • 若勾选“Download files from the above remote path to the receive directory”,系统会自动从以上指定的交易伙伴Remote Path路径,下载文件至指定的本地路径下。
  • Download Interval (minutes): 自动下载文件间隔时长(分钟)。
  • Retry Interval (minutes): 文件上传失败,重新上传间隔时长(分钟)。
  • Maximum Attempts: 文件重新上传最大尝试次数。更多
    • 在一次数据上传过程中,交易伙伴Server发送的response中缺少200 OK,则表示文件上传失败。
    • 文件下载失败可能是由于交易伙伴Server暂时性的错误。
    • 系统默认间隔时长为60分钟,最大尝试次数为5次。