SFTP - SSH

此連接器適用於以下產品和區域：

服務	Class	Regions
副駕駛工作室	標準	除下列區域外的所有 Power Automate 區域 ：      - 美國國防部 （DoD）
邏輯應用程式	標準	所有 Logic Apps 區域
Power Apps	標準	除下列區域外的所有 Power Apps 區域 ：      - 美國國防部 （DoD）
Power Automate（自動化服務）	標準	除下列區域外的所有 Power Automate 區域 ：      - 美國國防部 （DoD）

連絡人​​
名稱	Microsoft
URL	Microsoft LogicApps 支援 Microsoft Power Automate 支援 Microsoft Power Apps 支援

連接器中繼資料
Publisher	Microsoft

連接器操作指南

本文說明 SFTP-SSH 受控 連接器的作業，適用於 Azure Logic Apps、Power Automate 和 Power Apps。 SFTP 內建 連接器僅適用於 Azure Logic Apps 中的標準邏輯應用程式工作流程。 如需詳細資訊，請參閱在 Azure Logic Apps 中使用 SSH 連線到 SFTP 伺服器，以及 Azure Logic Apps 的 SFTP 內建連接器參考。

與已淘汰的 SFTP 受管理連接器的差異

相較於 已淘汰的 SFTP 受管理連接器，SFTP-SSH 受管理連接器提供下列主要功能：

• 使用 SSH.NET 程式庫，這是支援 .NET 的開放原始碼安全殼層 （SSH） 程式庫。

• 提供 建立資料夾 動作，可在 SFTP 伺服器上的指定路徑建立資料夾。

• 提供「 重新命名檔案 」動作，以重新命名 SFTP 伺服器上的檔案。

• 將與 SFTP 伺服器的連線快取最多 1 小時。 此功能可改善效能，並降低連接器嘗試連線至伺服器的頻率。 若要設定此快取行為的持續時間，請在 SFTP 伺服器上的 SSH 組態中編輯 ClientAliveInterval 屬性 。

驗證和權限

• 當您建立與 SFTP 伺服器的連線時，您必須提供 SFTP 伺服器位址、帳戶認證、SSH 私密金鑰和 SSH 私密金鑰密碼。 如果您的平台支援使用區塊上傳大型檔案，您也需要SFTP伺服器上根資料夾的讀取和寫入存取權。

• SFTP-SSH 連接器支援私密金鑰驗證和密碼驗證。 不過，SFTP-SSH 連接器僅支援下列私密金鑰格式、金鑰交換演算法、加密演算法和指紋：

  • 私鑰格式：OpenSSH 和 ssh.com 格式的 RSA（Rivest Shamir Adleman）和 DSA（數字簽名算法）密鑰。 如果您的私密金鑰是 PuTTY （.ppk） 檔案格式，請先 將金鑰轉換為 OpenSSH （.pem） 檔案格式。
  • 金鑰交換演算法：
    • 曲線25519-sha256
    • curve25519-sha256@libssh.org
    • ecdh-sha2-nistp256
    • ecdh-sha2-nistp384
    • ECDH-SHA2-NISTP521
    • diffie-hellman-group-exchange-sha256
    • diffie-hellman-group-exchange-sha1
    • diffie-hellman-group16-sha512
    • diffie-hellman-group14-sha256
    • diffie-hellman-group14-sha1
    • diffie-hellman-group1-sha1
  • 加密演算法：
    • aes256-ctr
    • 3DES-CBC
    • AES128-CBC
    • AES192-CBC
    • AES256-CBC
    • 河豚-CBC
    • 兩魚-CBC
    • 兩魚192-CBC
    • 兩魚128-CBC
    • 兩魚256-CBC
    • 弧四
    • 弧形128
    • 弧形256
    • 演員陣容128-CBC
    • aes128-ctr
    • aes192-ctr
  • 主機金鑰演算法：
    • ssh-rsa
    • ssh-dss
    • ssh-ed25519
    • ecdsa-sha2-nistp256
    • ecdsa-sha2-nistp384
    • ecdsa-sha2-nistp521
  • 指紋：MD5。 如需詳細資訊，請參閱 尋找 MD5 指紋。

• 當您為連線提供 SSH 私密金鑰時， 請勿手動輸入或編輯金鑰，這可能會導致連線失敗。 相反地，請確定您從 SSH 私密金鑰檔案複製金鑰，並將該金鑰貼到連線資訊方塊中。

  若要正確複製並貼上 SSH 私密金鑰，請依照下列步驟操作。

  1. 在任何文字編輯器中開啟您的 SSH 私密金鑰檔案。 這些步驟繼續使用記事本作為範例。

  2. 在記事本 的編輯功能 表中，選取 全選。 （按 Ctrl + A）

  3. 從 [編輯] 功能表中，選取 [複製]。

  4. 在 SFTP-SSH 連線資訊方塊中，將完整複製的金鑰貼到支援多行的 SSH私鑰 屬性中。 請勿手動輸入或編輯金鑰。

  5. 輸入完連線詳細資料之後，請選取 [建立]。

將 PuTTY 型金鑰轉換為 OpenSSH

PuTTY 格式和 OpenSSH 格式使用不同的副檔名。 PuTTY 格式使用 .ppk 或 PuTTY 私鑰，檔案副檔名。 OpenSSH 格式使用 .pem 或隱私增強型郵件檔案副檔名。 如果您的私密金鑰是 PuTTY 格式，且您必須使用 OpenSSH 格式，請先依照下列步驟將金鑰轉換為 OpenSSH 格式：

• 基於 Unix 的操作系統

  1. 如果您的系統上沒有安裝 PuTTY 工具，請立即執行此操作，例如：

     sudo apt-get install -y putty

  2. 執行下列命令，以建立可與 SFTP-SSH 連接器搭配使用的檔案：

     puttygen <path-to-private-key-file-in-PuTTY-format> -O private-openssh -o <path-to-private-key-file-in-OpenSSH-format>

     例如：

     puttygen /tmp/sftp/my-private-key-putty.ppk -O private-openssh -o /tmp/sftp/my-private-key-openssh.pem

• Windows 作業系統

  1. 如果您還沒有這樣做，請 下載最新的 PuTTY 生成器 （puttygen.exe） 工具，然後打開該工具。

  2. 在 PuTTY 金鑰產生器工具 （puttygen.exe） 中，在 動作 下，選取 載入。

  3. 瀏覽至 PuTTY 格式的私密金鑰檔案，然後選取 [開啟]。

  4. 從 轉換 功能表中，選取 匯出 OpenSSH 金鑰。

  5. 儲存副檔名為 .pem 的私密金鑰檔案。

尋找 MD5 指紋

如果 SFTP 伺服器的指紋和預期的指紋不相符，SFTP-SSH 連接器會拒絕連線。 要獲取 MD5 指紋，這是一個由冒號分隔的 16 對十六進制數字的序列，請嘗試以下選項。

你有鑰匙

MD5 鍵是一個以冒號分隔的 47 個字元的 字串。 要在擁有密鑰時獲取 MD5 指紋，您可以使用 ssh-keygen 等工具。

例如，從 Bash 提示中，輸入下列命令：

ssh-keygen -l -f id_rsa.pub -E md5

你沒有鑰匙

要在沒有密鑰時獲取 MD5 指紋，您可以使用 WinSCP 最新的服務器和協議信息對話框工具，或者您可以改用 PuTTY 配置工具：

1. 在 PuTTY 組態工具 （putty.exe） 中，在 [ 類別 ] 視窗中，展開 [連線>SSH>主機金鑰]。

2. 在 主機金鑰演算法偏好設定下，開啟 演算法選取原則 清單，然後檢查 RSA 是否出現在頂端。

3. 如果 RSA 未出現在頂端，請選取 [RSA]，然後選取 [ 向上 ]，直到 [RSA 移至頂端為止]。

4. 使用 PuTTY 連接到您的 SFTP 服務器。 建立連線之後，當 PUTTY 安全性警示出現時，請選取 [ 更多資訊]。

   備註

   如果未出現安全性警示，請嘗試清除 SshHostKeys 專案。 開啟 Windows 登錄編輯器，然後瀏覽至下列專案：

   Computer\HKEY_CURRENT_USER\Software\SimonTatham\PuTTY\SshHostKeys

5. 在出現 有關伺服器主機金鑰方塊的PuTTY：資訊 後，找到 MD5指紋 屬性，並複製 47個字元的字串值，如下範例所示：

   **:**:**:**:**:**:**:**:**:**:**:**:**:**:**:**

觸發程式的已知問題和限制

• SFTP 受控連接器觸發程式可能會遇到遺漏、不完整或延遲的結果。

  • 遺漏的結果

    SFTP 觸發程式會輪詢或檢查 SFTP 檔案系統，並尋找自上次輪詢以來變更的任何檔案來運作。 SFTP 受管理連接器會觸發使用檔案的上次修改時間戳記來比較檔案版本。

    如果您建立、新增或更新檔案的時間戳記早於目前追蹤的上次修改時間戳記，則 SFTP 受控連接器觸發程式將不會偵測到此檔案。

    因此，如果您使用在 SFTP 伺服器上建立、新增或更新檔案的外部工具或用戶端，請務必停用工具或用戶端中保留檔案上次修改時間戳記的任何功能。

    下表列出一些保留此時間戳記的常用工具，以及停用此功能的步驟：

    SFTP 用戶端	行動
    WinSCP	前往選項、>偏好設定>、傳輸、>編輯、>保留時間戳記>、停用。
    檔案Zilla	移至 傳輸 保留>傳輸檔案>的時間戳記停用。

  • 結果不完整或延遲

    當 SFTP 觸發程序檢查新建立、新增或更新的檔案時，觸發程序也會檢查該檔案是否完整。 例如，當觸發程序檢查 SFTP 伺服器時，檔案可能正在進行變更。 為了避免傳回不完整的檔案，觸發程式會記下檔案的時間戳記，但不會立即傳回檔案。 相反地，只有在觸發程式再次檢查伺服器時，觸發程式才會傳回檔案。

    有時，此行為可能會導致延遲持續時間幾乎是觸發程式輪詢間隔的兩倍。 由於此行為，如果您停用 SFTP 觸發器的 [分割開啟 ] 設定，SFTP 觸發程式可能不會同時傳回所有檔案。

一般已知問題與限制

• SFTP-SSH 受控連接器目前不支援下列 SFTP 伺服器：

  • Akamai NetStorage
  • FileMage 閘道
  • 全球景觀
  • IBM DataPower
  • 訊息方式
  • OpenText 安全 MFT
  • OpenText GXS
  • 適用於 Azure Blob 儲存體的 SFTP
  • VShell 安全文件傳輸服務器
  • AWS SFTP

• 使用單獨的 SFTP 資料夾進行檔案處理和上傳。

  請務必在 SFTP 伺服器上使用個別資料夾作為觸發程序，以監視檔案的處理和儲存上傳的檔案。 否則，觸發器將不會觸發並且行為不可預測。 例如，觸發程式可能會略過需要處理的隨機數目檔案。

  此限制意味著您需要一種方法在這些資料夾之間移動檔案。 如果您遇到此問題，請從受監控的資料夾中移除檔案，並使用不同的資料夾來儲存上傳的檔案。

• 若要管理共用多租用戶受管理連接器服務的負載，受管理 SFTP-SSH 連接器可以從相同的來源 IP 位址 （即連接器 IP 位址） 建立多個連線到目的地 （也就是您的 SFTP 伺服器）。 某些低流量區域可能只使用連接器 IP 位址後方的三個虛擬機器執行個體，這表示這些區域最多可以建立三個連線。 其他區域最多可以使用 20 個連線，因為它們在連接器 IP 位址後面具有相同數目的虛擬機器。

  如果您的 SFTP 伺服器限制連線數目，您的伺服器可能無法與受管理 SFTP-SSH 連接器搭配使用。 不過，您可以建立標準邏輯應用程式工作流程，以改用內建 SFTP 作業。 您可以控制橫向擴充限制，從而控制連線數目。

• 如果您在 SFTP-SSH 受控連接器與 SFTP 伺服器之間遇到密碼套件互通性問題，請嘗試建立標準邏輯應用程式工作流程，並改用 SFTP 內建作業。 SFTP 內建作業支援更廣泛的密碼套件。

• 此連接器可能會將 no-op 要求傳送至後端。

區塊化

• 在 Azure Logic Apps 和 Power Automate 中，下列受控 SFTP-SSH 連接器動作支援區塊化，其中動作可以啟用以較小片段處理大型檔案。 如需 Azure Logic Apps 中區塊化的詳細資訊，請參閱 [使用區塊處理大型訊息]]（/azure/logic-apps/logic-apps-handle-large-messages）。

  行動	分塊支持	覆寫區塊大小支援
  複製檔案	否	不適用
  建立檔案	Yes	Yes
  建立資料夾	不適用	不適用
  刪除檔案	不適用	不適用
  將存檔解壓縮到資料夾	不適用	不適用
  取得檔案內容	Yes	Yes
  使用路徑取得檔案內容	Yes	Yes
  取得檔案中繼資料	不適用	不適用
  使用路徑取得檔案中繼資料	不適用	不適用
  列出資料夾中的檔案	不適用	不適用
  重新命名檔案	不適用	不適用
  更新檔案	否	不適用

  支援分塊的 SFTP-SSH 動作可以處理最多 1 GB 的檔案，而不支援區塊化的 SFTP-SSH 動作可以處理最多 50 MB 的檔案。 預設區塊大小為 15 MB。 但是，此大小可以動態變化，從 5 MB 開始逐漸增加到最大 50 MB。 動態大小調整是根據網路延遲、伺服器回應時間等因素而定。

  當您指定要改用的常數區塊大小時，您可以覆寫此調適性行為。 此大小範圍為 5 MB 到 50 MB。 例如，假設您有一個 45 MB 的檔案，而網路可以支援該檔案大小而不會延遲。 調適性分塊會導致數個呼叫，而不是一個呼叫。 若要減少呼叫次數，您可以嘗試設定 50 MB 的區塊大小。 在不同的案例中，如果您的邏輯應用程式工作流程逾時，例如使用 15 MB 區塊時，您可以嘗試將大小減少至 5 MB。

  區塊大小與連線相關聯。 此屬性表示您可以針對支援區塊化的動作和不支援區塊化的動作使用相同的連線。 在此情況下，支援區塊化之動作的區塊大小範圍為 5 MB 到 50 MB。

  若要覆寫區塊化在 SFTP-SSH 動作上使用的預設調適性行為，您可以指定 5 MB 到 50 MB 的恆定區塊大小。

  1. 在設計工具上，在 SFTP-SSH 動作的右上角，選取省略符號按鈕 （...），然後選取 [設定]。

  2. 在 Content Transfer 下的 Chunk size 屬性中，輸入 from 5 to 50的整數值。

  3. 完成後，選取 [完成]。

• SFTP-SSH 觸發程式不支援訊息區塊化。 當觸發程式要求檔案內容時，它們只會選取 15 MB 或更小的檔案。 若要取得大於 15 MB 的檔案，請改為遵循下列模式：

  1. 使用僅傳回檔案屬性的 SFTP-SSH 觸發程式。 這些觸發程式的名稱包含說明 （僅限內容）。

  2. 遵循觸發程序，並 SFTP-SSH 取得檔案內容 動作。 此動作會讀取完整的檔案，並隱含地使用訊息區塊化。

故障排除

401 錯誤：「401 未經授權」

發生此錯誤可能是因為您沒有正確的認證或許可。 如需詳細資訊，請參閱 驗證和權限。

404 錯誤：「引用了不存在的檔案或資料夾」

當您使用 建立檔案 動作時，可能會發生此錯誤。 當動作在 SFTP 伺服器上建立檔案時，動作也會自動呼叫 SFTP 伺服器以取得檔案的中繼資料。

如果您在呼叫取得中繼資料之前立即移動新建立的檔案，則該檔案不再存在於預期的位置，而且您會收到 404 錯誤訊息， 對不存在的檔案或資料夾進行了參考。

如果您無法避免或延遲移動檔案，您可以按照以下步驟在建立檔案後略過讀取檔案的中繼資料：

1. 在 [建立檔案 ] 動作中，開啟 [新增參數 ] 清單，選取 [取得所有檔案中繼資料 ] 屬性，並將值設定為 [否]。

2. 如果您稍後需要此檔案中繼資料，您可以使用 「取得檔案中繼資料 」動作。

504 錯誤：「連線嘗試失敗，因為連線方在一段時間後未正確回應，或建立連線失敗，因為連線的主機無法回應」或「對 SFTP 伺服器的請求花費了超過 '00：00：30' 秒」

當您無法成功與 SFTP 伺服器建立連線時，可能會發生此錯誤。 此問題可能有不同的原因，因此請嘗試以下故障排除選項：

• 連線逾時為 20 秒。 檢查您的 SFTP 伺服器是否具有良好的效能，以及防火牆等中繼裝置是否增加額外負荷。

• 檢查您的 SFTP 伺服器是否限制了來自每個 IP 位址的連線數量。 任何此類限制都會阻礙連接器與 SFTP 伺服器之間的通訊。 請務必移除此限制。

• 如果您已設定防火牆，請務必將 您所在區域的受管連接器 IP 位址 新增至核准清單。

• 如果錯誤間歇性發生，請將 SFTP-SSH 動作上的 重試原則 設定變更為高於預設四次重試的重試計數。

• 若要降低連線建立成本，請在 SFTP 伺服器的 SSH 組態中，將 ClientAliveInterval 屬性增加到大約一小時。

• 查看 SFTP 伺服器日誌以檢查發送到 SFTP 伺服器的呼叫是否成功到達，要獲取有關連線問題的更多信息，您還可以在防火牆和 SFTP 伺服器上運行網絡跟踪。

一般限制

名稱	價值觀
在頻寬時間間隔內傳輸至/從連接器傳輸的 MB 數目上限 （每個連線）	1000
頻寬時間間隔 （以毫秒為單位）	60000

正在建立連線

連接器支援下列驗證類型：

預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。 如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
主機伺服器位址	字串	主機伺服器位址	對
使用者名	字串	使用者名	對
密碼	securestring	密碼
SSH 私密金鑰	securestring	SSH 私鑰（文件內容應完全按原樣提供，以多行格式提供）
SSH 私密金鑰密碼	securestring	SSH 私密金鑰密碼 （如果私密金鑰受密碼保護）
連接埠號碼	整數 (int)	SFTP 連接埠號碼 （例如：22）
停用 SSH 主機金鑰驗證	布爾 (bool)	停用 SSH 主機金鑰驗證？ （對/錯）
SSH 主機金鑰指紋	字串	SSH 主機金鑰指紋
根資料夾路徑	字串	根資料夾路徑。

節流限制

名稱	呼叫	續約期間
每個連線的 API 呼叫	150	60 秒

動作

使用路徑取得檔案中繼資料	此作業會使用檔案路徑取得檔案中繼資料。
使用路徑取得檔案內容	此作業會使用檔案路徑來取得檔案內容。
列出根資料夾中的檔案	此作業會取得根資料夾中的檔案。
列出資料夾中的檔案	此作業會取得資料夾中包含的檔案。
刪除檔案	此作業會刪除檔案。
取得檔案中繼資料	此作業會使用檔案識別碼取得檔案中繼資料。
取得檔案內容	此作業會使用檔案識別碼取得檔案內容。
將存檔解壓縮到資料夾	此作業會將封存檔案解壓縮到資料夾中（例如：.zip）。
建立檔案	此作業會上傳檔案。
建立資料夾	此作業會建立新的資料夾。
更新檔案	此作業會更新檔案內容。
複製檔案	此作業會複製檔案。
重新命名檔	此作業會重新命名檔案。

使用路徑取得檔案中繼資料

使用路徑取得檔案內容

列出根資料夾中的檔案

列出資料夾中的檔案

刪除檔案

取得檔案中繼資料

取得檔案內容

將存檔解壓縮到資料夾

建立檔案

建立資料夾

更新檔案

複製檔案

重新命名檔

觸發程序

新增或修改檔案時	當在資料夾中新增或修改檔案時，此作業會觸發流程。 觸發器將獲取文件元數據以及文件內容。 觸發程式依賴於檔案的上次修改時間。 如果檔案是由協力廠商用戶端建立，則應在用戶端中停用保留上次修改時間。 觸發程序會略過大於 50 MB 的檔案。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。
新增或修改檔案時 （僅限屬性）	當在資料夾中新增或修改檔案時，此作業會觸發流程。 此觸發器只會擷取檔案中繼資料。 若要取得檔案內容，您可以使用「取得檔案內容」操作。 觸發程式依賴於檔案的上次修改時間。 如果檔案是由協力廠商用戶端建立，則應在用戶端中停用保留上次修改時間。 如果在子資料夾中新增/更新檔案，則不會觸發觸發程式。 如果需要在子資料夾上觸發，則應建立多個觸發程式。

新增或修改檔案時

新增或修改檔案時 （僅限屬性）

定義

Blob中繼資料

BlobMetadata回應

二進位