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 上传不同类型数据的详细说明,请参考以下内容:
这篇文章有帮助吗?
很好!
感谢您的反馈。
抱歉我们没能带来帮助
感谢您的反馈。
反馈已发送
感谢,我们将试着改善此文档。