SFTP - SSH

このコネクタは、次の製品とリージョンで使用できます。

サービス	クラス	リージョン
コピロット スタジオ	Standard	次を除くすべての Power Automate リージョン :      - 米国国防総省 (DoD)
ロジック アプリ	Standard	すべての Logic Apps リージョン
Power Apps	Standard	次を除くすべての Power Apps リージョン :      - 米国国防総省 (DoD)
Power Automate	Standard	次を除くすべての Power Automate リージョン :      - 米国国防総省 (DoD)

お問い合わせ
名前	Microsoft
URL	Microsoft LogicApps のサポート Microsoft Power Automate のサポート Microsoft Power Apps のサポート

コネクタ メタデータ
Publisher	Microsoft

コネクタのハウツー ガイド

この記事では、Azure Logic Apps、Power Automate、Power Apps で使用できる SFTP-SSH マネージド コネクタの操作について説明します。 SFTP 組み込み コネクタは、Azure Logic Apps の Standard ロジック アプリ ワークフローでのみ使用できます。 詳細については、 Azure Logic Apps での SSH を使用した SFTP サーバーへの接続と、Azure Logic Apps用の SFTP 組み込みコネクタ リファレンスに関するページを参照してください。

非推奨の SFTP マネージド コネクタとの違い

非推奨の SFTP マネージド コネクタと比較して、SFTP-SSH マネージド コネクタには次の主要な機能があります。

• SSH.NET ライブラリを使用します。これは、.NET をサポートするオープンソースの Secure Shell (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) ファイル形式に変換します。
  • キー交換アルゴリズム:
    • curve25519-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
    • blowfish-cbc
    • twofish-cbc
    • twofish192-cbc
    • twofish128-cbc
    • twofish256-cbc
    • arcfour
    • arcfour128
    • arcfour256
    • cast128-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 ベースの OS

  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 OS

  1. まだ実行していない場合は、 最新の PuTTY ジェネレーター (puttygen.exe) ツールをダウンロードし、ツールを開きます。

  2. PuTTY キー ジェネレーター ツール (puttygen.exe) の [ アクション] で、[ 読み込み] を選択します。

  3. PuTTY 形式で秘密キー ファイルを参照し、[ 開く] を選択します。

  4. [変換] メニュー の [ OpenSSH キーのエクスポート] を選択します。

  5. .pem ファイル名拡張子を持つ秘密キー ファイルを保存します。

MD5 フィンガープリントを見つける

SFTP-SSH コネクタは、SFTP サーバーのフィンガープリントと予想されるフィンガープリントの両方が一致しない場合、接続を拒否します。 16 組の 16 桁の 16 桁の数字がコロンで区切られたシーケンスである MD5 フィンガープリントを取得するには、次のオプションを試してください。

キーがある

MD5 キーは、コロンで区切られた 47 文字の 文字列です。 キーがある場合に MD5 フィンガープリントを取得するには、ssh-keygen などのツールを使用できます。

たとえば、Bash プロンプトから次のコマンドを入力します。

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

キーがありません

キーがない場合に MD5 フィンガープリントを取得するには、 WinSCP で最新のサーバーとプロトコル情報ダイアログ ツールを使用するか、代わりに PuTTY 構成ツールを使用できます。

1. PuTTY 構成ツール (putty.exe) の [カテゴリ ] ウィンドウで、[ 接続>SSH>Host キー] を展開します。

2. [ ホスト キー アルゴリズムの基本設定] で、[ アルゴリズムの選択ポリシー ] の一覧を開き、 RSA が上部に表示されていることを確認します。

3. RSA が一番上に表示されない場合は、RSA を選択し、RSA が一番上に移動するまで [Up] を選択します。

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	> Preferences>Transfer>Edit>Preserve timestamp>Disable に移動します。
    FileZilla	転送>>Disable に移動します。

  • 不完全または遅延した結果

    SFTP トリガーが、新しく作成、追加、または更新されたファイルを確認すると、トリガーはファイルが完了したかどうかもチェックします。 たとえば、トリガーが SFTP サーバーをチェックするときに、ファイルの変更が進行中である可能性があります。 不完全なファイルが返されないようにするために、トリガーはファイルのタイムスタンプを記録しますが、すぐにはファイルを返しません。 代わりに、トリガーは、トリガーがサーバーをもう一度チェックする場合にのみ、ファイルを返します。

    場合によっては、この動作により、トリガーのポーリング間隔のほぼ 2 倍の遅延が発生することがあります。 この動作により、SFTP トリガーの 分割オン 設定を無効にした場合、SFTP トリガーはすべてのファイルを同時に返さない可能性があります。

一般的な既知の問題と制限事項

• 現在、SFTP-SSH マネージド コネクタでは、次の SFTP サーバーはサポートされていません。

  • Akamai NetStorage
  • FileMage ゲートウェイ
  • Globalscape
  • IBM DataPower
  • MessageWay
  • OpenText Secure MFT
  • OpenText GXS
  • Azure Blob Storage の SFTP
  • VShell Secure File Transfer Server
  • AWS SFTP

• ファイルの処理とアップロードには、個別の SFTP フォルダーを使用します。

  トリガーでファイルの処理とアップロードされたファイルの格納を監視するには、SFTP サーバー上の個別のフォルダーを使用してください。 それ以外の場合、トリガーは起動せず、予期しない動作をします。 たとえば、トリガーは、処理が必要なランダムな数のファイルをスキップする場合があります。

  この制限は、これらのフォルダー間でファイルを移動する方法が必要であることを意味します。 この問題が発生した場合は、監視対象フォルダーからファイルを削除し、別のフォルダーを使用してアップロードされたファイルを格納します。

• 共有マルチテナント マネージド コネクタ サービスの負荷を管理するために、マネージド SFTP-SSH コネクタは、同じソース IP アドレス(コネクタ IP アドレス)から宛先 (SFTP サーバー) への複数の接続を作成できます。 トラフィックの少ないリージョンでは、コネクタ IP アドレスの背後にある 3 つの仮想マシン インスタンスしか使用できない場合があります。つまり、これらのリージョンでは最大 3 つの接続を作成できます。 他のリージョンでは、コネクタの IP アドレスの背後にある仮想マシンの数が同じであるため、最大 20 個の接続を使用できます。

  SFTP サーバーで接続の数が制限されている場合、マネージド SFTP-SSH コネクタでサーバーが適切に動作しない可能性があります。 ただし、代わりに組み込みの SFTP 操作を使用する標準ロジック アプリ ワークフローを作成できます。 スケールアウト制限と、その結果、接続の数を制御できます。

• SFTP-SSH マネージド コネクタと SFTP サーバーの間で暗号スイートの相互運用性の問題が発生した場合は、Standard ロジック アプリ ワークフローを作成し、代わりに SFTP 組み込み操作を使用してみてください。 SFTP 組み込み操作では、より広範な暗号スイートがサポートされています。

• このコネクタは、バックエンドに no-op 要求を送信する場合があります。

Chunking

• Azure Logic Apps と Power Automate では、次のマネージド SFTP-SSH コネクタ アクションはチャンクをサポートしています。この場合、アクションを使用すると、サイズの大きいファイルをより小さな部分で処理できます。 Azure Logic Apps でのチャンクの詳細については、「[チャンクを使用して大きなメッセージを処理する]](/azure/logic-apps/logic-apps-handle-large-messages)を参照してください。

  アクション	チャンクのサポート	チャンク サイズのサポートをオーバーライドする
  ファイルのコピー	いいえ	適用なし
  ファイルの作成	イエス	イエス
  フォルダーの作成	適用なし	適用なし
  ファイルの削除	適用なし	適用なし
  フォルダーへのアーカイブの抽出	適用なし	適用なし
  ファイルの内容を取得する	イエス	イエス
  パスを使用してファイルコンテンツを取得する	イエス	イエス
  ファイル メタデータを取得する	適用なし	適用なし
  パスを使用してファイル メタデータを取得する	適用なし	適用なし
  フォルダー内のファイルを一覧表示する	適用なし	適用なし
  ファイル名の変更	適用なし	適用なし
  ファイルの更新	いいえ	適用なし

  チャンクをサポートする SFTP-SSH アクションでは最大 1 GB のファイルを処理できますが、チャンクをサポートしない SFTP-SSH アクションでは最大 50 MB のファイルを処理できます。 既定のチャンク サイズは 15 MB です。 ただし、このサイズは、5 MB から徐々に最大 50 MB に増加して、動的に変更される可能性があります。 動的なサイズ設定は、ネットワーク待機時間、サーバーの応答時間などの要因に基づいています。

  代わりに使用する一定のチャンク サイズを指定すると、このアダプティブ動作をオーバーライドできます。 このサイズの範囲は 5 MB から 50 MB です。 たとえば、待機時間なしでそのファイル サイズをサポートできる 45 MB のファイルとネットワークがあるとします。 アダプティブ チャンクでは、1 回の呼び出しではなく、複数の呼び出しが行われます。 呼び出しの数を減らすために、50 MB のチャンク サイズを設定してみてください。 異なるシナリオでは、ロジック アプリ ワークフローがタイムアウトしている場合 (たとえば、15 MB のチャンクを使用する場合) は、サイズを 5 MB に縮小してみてください。

  チャンク サイズは接続に関連付けられます。 この属性は、チャンクをサポートするアクションとチャンクをサポートしないアクションの両方に同じ接続を使用できることを意味します。 この場合、チャンクをサポートするアクションのチャンク サイズは、5 MB から 50 MB の範囲です。

  SFTP-SSH アクションでチャンクが使用する既定のアダプティブ動作をオーバーライドするには、5 MB から 50 MB までの一定のチャンク サイズを指定できます。

  1. デザイナーで、SFTP-SSH アクションの右上隅にある省略記号ボタン (...) を選択し、[ 設定] を選択します。

  2. [ コンテンツ転送] の [ チャンク サイズ ] プロパティに、 5 から 50までの整数値を入力します。

  3. 完了したら、[ 完了] を選択します。

• SFTP-SSH トリガーでは、メッセージチャンクはサポートされていません。 トリガーは、ファイルの内容を要求するときに、15 MB 以下のファイルのみを選択します。 15 MB を超えるファイルを取得するには、代わりに次のパターンに従います。

  1. ファイルのプロパティのみを返す SFTP-SSH トリガーを使用します。 これらのトリガーには、説明を含む名前 があります (プロパティのみ)。

  2. [ ファイル コンテンツの取得 ] アクション SFTP-SSH トリガーに従います。 このアクションは、完全なファイルを読み取り、メッセージ チャンクを暗黙的に使用します。

トラブルシューティング

401 エラー: "401 Unauthorized"

このエラーは、正しい資格情報またはアクセス許可がないために発生する可能性があります。 詳細については、「 認証とアクセス許可」を参照してください。

404 エラー: "存在しないファイルまたはフォルダーへの参照が行われました"

このエラーは、 ファイルの作成 アクションを使用するときに発生する可能性があります。 アクションによって SFTP サーバー上にファイルが作成されると、SFTP サーバーへの呼び出しも自動的に送信され、ファイルのメタデータが取得されます。

呼び出しでメタデータを取得する前に、新しく作成されたファイルをすぐに移動すると、ファイルは予期された場所に存在しなくなり、404 エラー メッセージが表示 されます。存在しないファイルまたはフォルダーへの参照が行われました。

ファイルの移動を回避または遅延できない場合は、次の手順に従って、ファイルの作成後にファイルのメタデータの読み取りをスキップできます。

1. [ ファイルの作成 ] アクションで、[ 新しいパラメーターの追加] リストを開 き、[すべてのファイル メタデータの取得 ] プロパティを選択し、値を [いいえ] に設定します。

2. 後でこのファイル メタデータが必要な場合は、[ ファイル メタデータの取得 ] アクションを使用できます。

504 エラー: "接続されたパーティーが一定期間後に適切に応答しなかったために接続が失敗しました。接続されたホストが応答に失敗したために確立された接続が失敗しました" または "SFTP サーバーへの要求に '00:00:30' 秒以上かかった"

このエラーは、SFTP サーバーとの接続を正常に確立できない場合に発生する可能性があります。 この問題にはさまざまな理由がある可能性があるため、次のトラブルシューティング オプションを試してください。

• 接続タイムアウトは 20 秒です。 SFTP サーバーのパフォーマンスが良好で、ファイアウォールなどの中間デバイスがオーバーヘッドを増やしていないことを確認します。

• SFTP サーバーが各 IP アドレスからの接続数に制限を設定しているかどうかを確認します。 このような制限は、コネクタと SFTP サーバー間の通信を妨げます。 この制限は必ず削除してください。

• ファイアウォールが設定されている場合は、必ず リージョンのマネージド コネクタの IP アドレス を承認済み一覧に追加してください。

• エラーが断続的に発生する場合は、SFTP-SSH アクションの 再試行ポリシー 設定を、既定の 4 回の再試行よりも大きい再試行回数に変更します。

• 接続確立コストを削減するには、SFTP サーバーの SSH 構成で ClientAliveInterval プロパティを約 1 時間に増やします。

• SFTP サーバー ログを確認して、SFTP サーバーに送信された呼び出しが正常に到着したかどうかを確認します。接続の問題に関する詳細情報を取得するには、ファイアウォールと SFTP サーバーでネットワーク トレースを実行することもできます。

一般的な制限

名前	価値
帯域幅の時間間隔内でコネクタとの間で転送される最大メガバイト数 (接続ごと)	1000
帯域幅の時間間隔 (ミリ秒単位)	60000

接続を作成する

コネクタでは、次の認証の種類がサポートされています。

デフォルト	接続を作成するためのパラメーター。	すべてのリージョン	共有不可

デフォルト

適用対象: すべてのリージョン

接続を作成するためのパラメーター。

これは共有可能な接続ではありません。 電源アプリが別のユーザーと共有されている場合、別のユーザーは新しい接続を明示的に作成するように求められます。

名前	タイプ	Description	必須
ホスト サーバー のアドレス	文字列	ホスト サーバー のアドレス	正しい
ユーザー名	文字列	ユーザー名	正しい
パスワード	securestring	パスワード
SSH 秘密キー	securestring	SSH 秘密キー (ファイルの内容は、すべてマルチライン形式でそのまま提供する必要があります)
SSH 秘密キーのパスフレーズ	securestring	SSH 秘密キーパスフレーズ (秘密キーがパスフレーズによって保護されている場合)
ポート番号	整数 (int)	SFTP ポート番号 (例: 22)
SSH ホスト キーの検証を無効にする	ブール (bool)	SSH ホスト キーの検証を無効にする (True/False)
SSH ホスト キーのフィンガープリント	文字列	SSH ホスト キーのフィンガープリント
ルート フォルダーのパス	文字列	ルート フォルダーのパス。

調整制限

名前	呼び出し	更新期間
接続ごとの API 呼び出し	150	60 秒

アクション

パスを使用してファイル メタデータを取得する	この操作では、ファイル パスを使用してファイル メタデータを取得します。
パスを使用してファイルコンテンツを取得する	この操作では、ファイル パスを使用してファイルの内容を取得します。
ファイル コンテンツの取得	この操作では、ファイル ID を使用してファイルの内容を取得します。
ファイルのコピー	この操作により、ファイルがコピーされます。
ファイルのメタデータを取得する	この操作では、ファイル ID を使用してファイル メタデータを取得します。
ファイルを作成する	この操作により、ファイルがアップロードされます。
ファイルを削除する	この操作により、ファイルが削除されます。
ファイルを更新する	この操作により、ファイルの内容が更新されます。
ファイル名の変更	この操作により、ファイルの名前が変更されます。
フォルダーへのアーカイブの抽出	この操作により、アーカイブ ファイルがフォルダー (例: .zip) に抽出されます。
フォルダーを作成する	この操作により、新しいフォルダーが作成されます。
フォルダー内のファイルを一覧表示する	この操作では、フォルダーに含まれるファイルを取得します。
ルート フォルダー内のファイルを一覧表示する	この操作では、ルート フォルダー内のファイルを取得します。

パスを使用してファイル メタデータを取得する

パスを使用してファイルコンテンツを取得する

ファイル コンテンツの取得

ファイルのコピー

ファイルのメタデータを取得する

ファイルを作成する

ファイルを削除する

ファイルを更新する

ファイル名の変更

フォルダーへのアーカイブの抽出

フォルダーを作成する

フォルダー内のファイルを一覧表示する

ルート フォルダー内のファイルを一覧表示する

トリガー

ファイルが追加または変更されたとき	この操作は、フォルダー内でファイルが追加または変更されたときにフローをトリガーします。 トリガーは、ファイル メタデータとファイルの内容の両方をフェッチします。 トリガーは、ファイルの最終変更時刻に依存します。 サード パーティのクライアントによってファイルが作成されている場合は、クライアントで最終変更時刻の保持を無効にする必要があります。 50 MB を超えるファイルは、トリガーによってスキップされます。 サブフォルダーにファイルが追加または更新された場合、トリガーは起動しません。 サブフォルダーでトリガーする必要がある場合は、複数のトリガーを作成する必要があります。
ファイルが追加または変更されたとき (プロパティのみ)	この操作は、フォルダー内でファイルが追加または変更されたときにフローをトリガーします。 このトリガーでは、ファイル メタデータのみがフェッチされます。 ファイルの内容を取得するには、"ファイル コンテンツの取得" 操作を使用できます。 トリガーは、ファイルの最終変更時刻に依存します。 サード パーティのクライアントによってファイルが作成されている場合は、クライアントで最終変更時刻の保持を無効にする必要があります。 サブフォルダーにファイルが追加または更新された場合、トリガーは起動しません。 サブフォルダーでトリガーする必要がある場合は、複数のトリガーを作成する必要があります。

ファイルが追加または変更されたとき

ファイルが追加または変更されたとき (プロパティのみ)

定義

BlobMetadata

BlobMetadataResponse

binary