SFTP 設定指南

建立者 Ashish Chaudhary, 修改時間星期六, 4 十月於 9:55 PM 由 Ashish Chaudhary

SFTP－設定說明

SFTP－設定說明

主機與驗證方式

我們會在專屬的 SFTP 伺服器（AWS 架設）上為您建立 SFTP 資料夾。每位客戶都會有一組專屬帳號，只能存取自己的 SFTP 資料夾。我們支援金鑰驗證，所以您需要先產生一組公開金鑰與私密金鑰，並將公開金鑰填入 Public Key 欄位。金鑰格式需為 openSSH RSA 。如何產生金鑰，請參考下方如何產生 SFTP 伺服器用的公開 SSH 金鑰說明。

設定方式

請將您產生的公開金鑰填入 Public Key 欄位。您也可以選擇修改 Username 欄位。 Username 欄位必須以英文字母、數字或底線開頭，長度需為 3 到 100 個字元。內容可以包含英文字母、數字、底線、@、點（.）及連字號（-）。
請將 Username、 Spotnana 網域網址及 Port number 等資訊妥善保存，之後公司內部需要設定檔案傳送時會用到這些資料。
提醒您：完成 SFTP 資料夾設定後，這些資訊日後也可以在管理頁面再次查詢。
如果您希望收到檔案上傳狀態報告，請在 SFTP 電子郵件通知欄位填入您的電子郵件。詳細說明請見下方報告與錯誤處理。
點選 Connect即可。

當您新增公開金鑰後，初始狀態會顯示為未驗證。在 OBT 上會一直顯示這個狀態，直到有檔案傳送到資料夾為止。您可以先傳測試檔，也可以直接傳 HR feed 或自訂欄位檔案（僅支援的格式才會處理）。另外，如果之後有更新公開金鑰，狀態也會重新變成未驗證，直到再次收到檔案為止。

若要移除您的 SFTP 資料夾，請點選 Disconnect，這樣就會刪除該資料夾。若日後需要重新設定，請依上述步驟重新填寫所有資料。

檔案上傳頻率與排程

檔案上傳的頻率與排程由您自行決定。我們會偵測檔案建立的動作來啟動後續處理，也就是說，只要您將檔案傳到我們的 SFTP 資料夾，系統就會自動開始處理該檔案。

如果想了解不同資料類型（例如使用者、自訂欄位、法人單位等）建議的上傳頻率與排程，請參考 SFTP 各類資料說明的「檔案上傳頻率與排程」 章節。

報告與錯誤處理

我們會針對每次檔案上傳進行記錄，並產生內部報告，將報告寄到您在 SFTP 電子郵件通知欄位所填的信箱。每次上傳後，報告內容會包含：

檔案上傳失敗的原因（如格式錯誤、欄位名稱缺漏等）。
檔案內某一列無法上傳的原因。系統不會做部分更新，只要某一列有錯誤或必填欄位沒填，該列就會被判為失敗。
上傳狀態（待處理、成功、失敗）。

您可以參考這份報告內容來排除錯誤。如果還是無法解決，歡迎聯絡技術支援團隊協助處理。

我們是否接受只包含需新增或更新資料的增量檔案？
- 可以
無論是透過 SFTP 或手動上傳，檔案是否一定要包含那些您沒在用的選填欄位？
- 不用

如何產生 SFTP 伺服器用的公開 SSH 金鑰

請依照下方步驟產生您要提供給我們的公開 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=

各類資料的操作說明

如果您需要針對不同資料類型上傳的詳細操作方式，請參考以下說明：