SFTP 设置指南

创建者 Ashish Chaudhary, 修改于星期六, 4 十月在 11:15 AM 由 Ashish Chaudhary

SFTP - 配置指南

SFTP - 配置指南

主机与身份验证

我们会为您单独分配一个 SFTP 文件夹，并在专属的 SFTP 服务器（基于 AWS）上进行托管。每位客户都会有独立的账户，只能访问自己专属的 SFTP 文件夹。我们支持密钥认证，因此，您需要先生成一对公私钥，并在公钥字段中填写公钥，格式要求为 openSSH RSA 。如需生成密钥，请参考下方如何为 SFTP 服务器生成公钥的说明。

配置

请将您生成的公钥填写到公钥字段中。您也可以根据需要修改 用户名 字段。 用户名 需以字母、数字或下划线开头，长度为 3 到 100 个字符。用户名可包含字母、数字、下划线、@、点（.）和短横线（-）。
请将用户名、 Spotnana 域名地址和端口号等信息妥善保存，方便后续您公司内部负责配置文件上传的同事使用。
注意： SFTP 文件夹配置完成后，这些信息可以在管理页面再次查看。
如需接收文件上传报告，请在 SFTP 邮件通知字段填写您的邮箱地址。详细说明请见下方报告与错误处理部分。
点击连接按钮。

添加公钥后，初始状态会显示为未验证。在文件夹收到实际文件前，OBT 页面会一直显示“未验证”。您可以上传任意测试文件，也可以上传正式的 HR 数据或自定义字段文件（仅支持指定格式的文件）。如果后续更新了公钥，状态也会重新变为未验证，直到下次接收到文件为止。

如需删除 SFTP 文件夹，请点击 断开连接。这样会移除您的 SFTP 文件夹。如需重新配置，需从头填写上述所有信息。

上传频率与计划

文件上传的频率和时间由您自行决定。我们会在检测到新文件上传到 SFTP 文件夹后，立即启动文件处理流程。也就是说，您只要把文件上传到 SFTP 文件夹，我们的系统就会自动开始处理。

如果需要针对不同数据类型（如用户、自定义字段、法人实体等）的上传频率建议，请参考每种数据类型的 上传频率与计划 SFTP 配置说明。

报告与错误处理

我们会收集您的文件上传数据，并在每次上传后生成内部报告，发送到您在 SFTP 邮件通知字段填写的邮箱。每个文件的报告内容包括：

文件上传失败的原因（如格式错误、缺少列名等）。
文件中某一行上传失败的具体原因。我们不支持部分更新，如果某行某列有错误或必填项缺失，则该行会整体上传失败。
上传状态（待处理、成功、失败）。

您可以根据报告内容排查并修正错误。如无法自行解决，请联系技术支持。

我们是否支持只包含需新增或更新记录的增量文件？
- 支持
无论通过 SFTP 还是手动上传，文件是否必须包含所有可选列（即使这些列未被使用）？
- 不需要

如何为 SFTP 服务器生成公钥

请按照以下步骤生成 SSH 公钥，并提供给我们。

格式

类型：字符串
长度限制：最长 2048 字符。

格式要求

^ssh-rsa\s+[A-Za-z0-9+/]+[=]{0,3}(\s+.+)?\s*$

生成 SSH 密钥

在 Windows 命令行或 macOS、Linux、UNIX 终端中运行以下命令即可生成 SSH 密钥：

ssh-keygen -t rsa -b 4096 -f key_name

其中

-t 代表加密类型
-b 代表密钥长度（位数）
-f 代表密钥文件名

密钥示例

ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDDJB9oBRPrBegMDPEQo+HmNDb/jKUJL6q2kQpNNMDjNps9mhhwJ1dP/lOavMitBPAndeXlwaNEm2XbGaSrZtD/tbQTX1HQjP6pacy+Alf8kYBm5QFfl/Z6lGC8qHys10fpRXgYE7UhdSv6VyRqt1gELGFQwVBZ2kJJuBGJF1IRywwvG/h68B8iWU1+6KEWYQoUcT45r3j3otnx4NhhzpTiNgDbMk0ix+kar4/IstobRLcb7rt7FoUerTLNrVDi69DqbsGY5LN+NM8jVx0sPQLRC/ruil8pTHP3k4rDCc7a80+sH4sUTW+mHc7MTqbi/CcyyFAD8h7p6WqxEydOaJjMnvqAbE17BOj0TSxv3HMohTf3skzE7PbzVcjIfHTpFPGxmJkghAYAMi5l9VvAs91IpVylxjqPss3xQQJIZEmQdG2k7zk/UpsUFlmaOj6lCHRicFKCixKekzzm3nFuJvDEklurtydOQjZ8WkPzTSJfZBdKMuMUi0SQ9m9ZAw99t0=

各类数据类型的操作说明

如需了解通过 SFTP 上传不同类型数据的详细说明，请参考以下内容：