Workiva 支援中心

透過 SFTP 連接器，您可以在鏈結中使用命令來管理安全檔案傳輸協定 (SFTP) 伺服器上的檔案和目錄。例如，透過此連接器，您可以使用範本建立鏈結，以從 SFTP 伺服器安全地下載檔案，然後將其上傳到 Wdata 表格。

必要條件

若要使用 SFTP 連接器，您的組織需要能存取自己的 SFTP 伺服器。Workiva 既不能託管也不能提供這些伺服器。

為了保護與 SFTP 伺服器的連線，此連接器支援基本使用者名稱和密碼驗證，或公用金鑰/私鑰驗證。要設定連線，您需要：

• 伺服器的主機名稱或 IP 位址
• 伺服器執行的連接埠
• 用於存取伺服器的使用者名稱
• 使用者名稱的驗證憑證：
  • 基本驗證需要使用其密碼
  • 對於公開金鑰驗證，則需要 PEM 或 PPK 的私密金鑰檔案，及其密碼 (如果適用)進一步瞭解私密金鑰。

設定 SFTP 連結器

注意：為了使連接器可用於組織的鏈結，組織安全性管理員首先要從組態中啟用它。

1. 在「鏈結產生器」中，按一下「連線」compare_arrows，然後按一下右上角的「建立」。
2. 在Connector Connection 下 ，選擇SFTP Connector 和您的執行器。
   
3. 在「基本資訊」(Basic Info) 下，輸入唯一的名稱和描述以識別連結。
4. 若使用公開金鑰驗證，在「資源」下，請上傳伺服器的私密金鑰檔案。 
5. 在「屬性」(Properties) 下，輸入連結的詳細資料：
   

   摘要資訊	詳細資料
   寄存	輸入 SFTP 伺服器的主機名稱或 IP 位址，例如 34.23.34.45 或 sftp.example.net。
   連接埠	輸入伺服器執行的連接埠。
   使用者名稱	輸入用來登入伺服器的使用者名稱。
   密碼	對於基本驗證，請輸入使用者名稱的密碼。對於公用金鑰驗證，請留空。
   私密金鑰	對於公開金鑰認證，請在「資源」(Resources) 下輸入所上傳的私密金鑰的檔案名稱。
   私密金鑰密碼	對於公用金鑰驗證，請輸入私密金鑰檔案的密碼。如果私密金鑰沒有密碼，請留空。
   連結逾時	輸入連線至 SFTP 伺服器的等待分鐘數。如果伺服器速度較慢或負載較高，請輸入較大的數字。

   注意：所有敏感認證都會自動加密並以進階加密標準 (AES)-256 加密方式儲存。

6. 請選取要使用連結的環境，然後按一下「儲存」(Save)。
7. 如果您的網路需要輸出網域的允許清單，請允許在允許 Workiva 的主機和電子郵件文件中列出的 IP 位址：
8. 若要測試連結，請使用SFTP 連接器的「列出目錄」(List Directory) 命令來建立並執行鏈結，並驗證其是否傳回有效的輸出內容。

疑難排解

如果與 SFTP 伺服器的連結失敗：

• 驗證連接器的驗證認證是否正確。例如，使用相同認證透過 SFTP 用戶端應用程式（如 FileZilla 或 WinSCP）連線到伺服器。
• 檢查您的密碼是否以「at」符號 (@) 開頭。
• 如果連結逾時，請增加「連結逾時」(Connection Timeout) 屬性。
• 如果您的網路需要輸出網域的允許清單，請遵循 允許 Workiva 的主機和電子郵件文件

私密金鑰

如果 SFTP 用戶端應用程式不允許您產生公用/私密金鑰組，請使用 PuTTYgen 等工具。 對於私人金鑰，我們支援下列格式：

• PuTTy 產生的金鑰，通常以.ppk 副檔名結束。
• 以 PEM 格式使用 PKCS#1 標準的 RSA 金鑰，通常以.pem 副檔名結束。

您也可以在文字編輯器中檢視您的 RSA 金鑰。如果文本包含-----BEGIN RSA PRIVATE KEY----- 和-----END RSA PRIVATE KEY----- ，则 Workiva 支持这些格式。如果缺少這些行或包含不同的術語，則需要將密鑰轉換為此格式或產生新密鑰。

架構