SFTP 連結器

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

先決條件

若要使用 SFTP 連接器，您的組織需要能存取自己的 SFTP 伺服器。

注意：Workiva 無法存放或提供 SFTP 伺服器。

為了保護與SFTP服務器的連接，連接器支援基本的用戶名和密碼認證或公鑰/私鑰認證。要建立連接，您需要：

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

  注意：如果您的 SFTP 用戶端應用程式不允許您產生公開/私密金鑰組，請使用 PuTTYgen 或 ssh-keygen 等工具。

設定 SFTP 連結器

注意：為了使該連接器可在您的組織連結中使用，組織安全管理員首先要從「設定」中啟用它。

1. 從「鏈結」(Chains)，按一下「連結」(Connections) compare_arrows，然後按一下「新增連結」(Add Connection) add。
2. 在「BizApp 連結」(BizApp Connection) 下，選取「SFTP 連接器」(SFTP Connector) 和預設的「CloudRunner」。
   
3. 在「基本資訊」(Basic Info) 下，輸入唯一的名稱和描述以識別連結。
4. 若使用公開金鑰驗證，請在「資源」(Resources) 下，上傳伺服器的私密金鑰檔案。
5. 在「屬性」(Properties) 下，輸入連結的詳細資料：
   

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

   注意：所有敏感性憑證都會自動加密並以高級加密標準 (AES)-256 加密儲存。

6. 請選取要使用連結的環境，然後按一下「儲存」(Save)。
7. 如果您的網絡需要出站域的允許列表，請允許IP地址：
   • 美國的生產應用程式為 34.199.100.193
   • 歐盟的生產應用程式為 54.76.117.194
8. 若要測試連結，請使用SFTP 連接器的「列出目錄」(List Directory) 命令來建立並執行鏈結，並驗證其是否傳回有效的輸出內容。

疑難排解

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

• 請確認連接器的驗證憑證是否正確。例如，使用相同的憑證透過 SFTP 用戶端應用程式 (例如 FileZilla 或 WinSCP) 連結到伺服器。
• 如果連結逾時，請增加「連結逾時」(Connection Timeout) 屬性。
• 如果您的網絡需要域出站的允許列表，請允許IP地址：
  • 美國的生產應用程式為 34.199.100.193
  • 歐盟的生產應用程式為 54.76.117.194