---
schema_version: "1"
id: 98d2dc50f35dcb406730a277c66ce5ae0d9734e760c38b3d6703540da1057183
title: SFTP Connector のバージョン 2.x へのアップグレードおよび移行
collection: mulesoft
version: current
locale: ja-jp
portal_url: https://docs.salesforce.com/mulesoft/current/ja-jp/sftp-connector/2.2/sftp-connector-upgrade-guide.md
canonical_url: https://docs.mulesoft.com/jp/sftp-connector/2.2/sftp-connector-upgrade-guide
source_site: docs.mulesoft.com
content_type: documentation
content_hash: 24a76ebbbfb1a6d633b0a24c21086bccd7b3f73e8303a0152ab1bc8b7fd3c442
description: MuleSoft Documentation Site
release: "2.2"
latest: false
---
# SFTP Connector のバージョン 2.x へのアップグレードおよび移行

SFTP 用 Anypoint Connector (SFTP Connector) をバージョン 2.x.x にアップグレードします。

## [](#サポートされているアップグレードパス)サポートされているアップグレードパス

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 50%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">開始バージョン</th>
<th class="tableblock halign-left valign-top">終了バージョン</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>1.6.0</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>2.x.x</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#このリリースでの変更)このリリースでの変更

このリリースには、次の変更が含まれています。

- システムプロパティ ​`mule.sftp.useHomeDirectory`​ が削除されました。SFTP Connector でデフォルトホームディレクトリが使用されるようになりました。
- SFTP Connector 2.x.x で ​`jcraft ライブラリ`​がサポートされなくなりました。コネクタで ​`apache mina sshd`​ ライブラリが使用されるようになりました。
- **List**​ 操作で、各ファイルのコンテンツが取得されなくなりました。各リスト項目のペイロードに検出されたファイルまたはディレクトリへの完全パスが含まれるようになりました。
- SFTP の ​**\[Regular Size (通常サイズ)\]**​ ファイル属性は、その動作がサイズに関連していないため、​**\[Regular File (正規ファイル)\]**​ という名前に変更されました。ファイル属性値には、ファイル (​`true`​) またはディレクトリ (​`false`​) を使用できます。
- SFTP Connector 2.x.x では、暗号化 ​`3des-ctr`​ および ​`arcfour`​ はサポートされていません。詳細は、​[「サポートされている暗号化」](#supported-ciphers)​を参照してください。
- SFTP プロキシプロトコルは、HTTP と SOCKS5 でのみ機能します。
- SFTP Connector でファイルのメディア種別を解決するために ​`javax.activation`​ が使用されなくなりました。コネクタで ​`Apache Tika`​ が使用されるようになりました。そのため、メディアファイルの解釈が異なる可能性があります。
- コネクタで日付を管理するクラスが ​`LocalDateTime`​ から ​`ZonedDateTime`​ に変更されました。
- 設定の非推奨の ​**\[Encoding (エンコード)\]**​ パラメーターと ​**Write**​ 操作が削除されました。コネクタでは Mule のデフォルトエンコードが使用されます。

## [](#要件)要件

アップグレードを実行する前に、次の要件を満たしていることを確認します。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 50%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">ソフトウェア</th>
<th class="tableblock halign-left valign-top">バージョン</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Mule</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>4.3.0 以降</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>Anypoint Studio</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>7.5.0 以降</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>JDK</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>8</p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#アップグレード前提条件)アップグレード前提条件

アップグレードを実行する前に、次の作業を完了する必要があります。

- 以前のバージョンに復元する必要がある場合に備えて、ファイル、データ、設定のバックアップを作成します。

## [](#アップグレード手順)アップグレード手順

以下の手順でアップグレードを実行します。

1. Anypoint Studio で、Mule プロジェクトを作成します。
2. **\[Mule Palette (Mule パレット)\]**​ で、​**\[Search in Exchange (Exchange 内を検索)\]**​ をクリックします。
3. **\[Add Dependencies to Project (連動関係をプロジェクトに追加)\]**​ で、検索項目に​`「SFTP」`​と入力します。
4. **\[Available modules (使用可能なモジュール)\]**​ で、​**\[SFTP Connector\]**​ を選択して ​**\[Add (追加)\]**​ をクリックします。
5. **\[Finish (完了)\]**​ をクリックします。
6. Mule プロジェクトの ​`pom.xml`​ ファイルで SFTP Connector ​`mule-sftp-connector`​ のバージョンが ​`2.x.x`​ であることを確認します。

Studio はコネクタを自動的にアップグレードします。

## [](#アップグレード後の手順)アップグレード後の手順

コネクタの最新バージョンをインストールしたら、次の手順に従ってアップグレードを完了します。

### [](#アップグレードを確認する)アップグレードを確認する

コネクタの最新バージョンをインストールしたら、アップグレードを確認します。

1. Studio の ​**\[Problems (問題)\]**​ または ​**\[Console (コンソール)\]**​ ビューでエラーがないことを確認します。
2. プロジェクトの ​`pom.xml`​ ファイルに問題がないことを確認します。
3. 接続をテストして、操作が機能することを確認します。

## [](#supported-ciphers)サポートされている暗号化

Apache Mina SSHD ライブラリでは、暗号化 ​`3des-ctr`​ および ​`arcfour`​ はサポートされていません。代わりに ​`aes128-gcm`​、​`aes256-gcm`​、​`cc20p1305_openssh`​ が導入されています。

<table><tbody><tr><td class="icon"><i class="fa icon-note" title="Note"></i></td><td class="content">現在のバージョンの SFTP Connector では、Apache Mina のデフォルトオプションに従う必要があります。 <a href="https://github.com/apache/mina-sshd/blob/sshd-2.12.1/docs/standards.md#implementedavailable-support">「Apache Mina Supported Standards (Apache Mina のサポートされている基準)」</a>​を参照してください。</td></tr></tbody></table>

詳細は、次の表を参照してください。

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 50%;">
<col style="width: 50%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">JSCH - SFTP Connector 1.6</th>
<th class="tableblock halign-left valign-top"><a href="https://github.com/apache/mina-sshd/blob/sshd-2.9.2/sshd-common/src/main/java/org/apache/sshd/common/cipher/BuiltinCiphers.java">MINA SSHD</a>​ - SFTP Connector 2.0</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>blowfish-cbc</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>blowfish-cbc</code>​ (廃止)</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>3des-cbc</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>3des-cbc</code>​ (廃止)</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>3des-ctr</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サポートされていません。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>aes128-cbc</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>aes128-cbc</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>aes128-ctr</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>aes128-ctr</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サポートされていません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>aes128-gcm</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>aes192-cbc</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>aes192-cbc</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>aes192-ctr</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>aes192-ctr</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>aes256-cbc</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>aes256-cbc</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>aes256-ctr</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>aes256-ctr</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サポートされていません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>aes256-gcm</code></p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>arcfour</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サポートされていません。</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>arcfour128</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>arcfour128</code>​ (廃止)</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>arcfour256</code></p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>arcfour256</code>​ (廃止)</p>
</div></div></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p>サポートされていません。</p>
</div></div></td>
<td class="tableblock halign-left valign-top"><div class="content"><div class="paragraph">
<p><code>cc20p1305_openssh</code></p>
</div></div></td>
</tr>
</tbody>
</table>

## [](#supported-cryptographic-entities)その他のサポートされている暗号化エンティティ

<table class="tableblock frame-all grid-all stretch">
<colgroup>
<col style="width: 33.3333%;">
<col style="width: 33.3333%;">
<col style="width: 33.3334%;">
</colgroup>
<thead>
<tr>
<th class="tableblock halign-left valign-top">キーアルゴリズム</th>
<th class="tableblock halign-left valign-top">ホストキーアルゴリズム</th>
<th class="tableblock halign-left valign-top">MAC</th>
</tr>
</thead>
<tbody>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>curve25519-sha256</code>​*</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ecdsa-sha2-nistp256-cert-v01@openssh.com</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>hmac-sha2-256-etm@openssh.com</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>curve25519-sha256@libssh.org</code>​*</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ecdsa-sha2-nistp384-cert-v01@openssh.com</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>hmac-sha2-512-etm@openssh.com</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>curve448-sha512</code>​*</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ecdsa-sha2-nistp521-cert-v01@openssh.com</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>hmac-sha1-etm@openssh.com</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ecdh-sha2-nistp521</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ssh-ed25519-cert-v01@openssh.com</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>hmac-sha2-256</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ecdh-sha2-nistp384</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>rsa-sha2-512-cert-v01@openssh.com</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>hmac-sha2-512</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ecdh-sha2-nistp256</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>rsa-sha2-256-cert-v01@openssh.com</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>hmac-sha1</code></p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>diffie-hellman-group-exchange-sha256</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ecdsa-sha2-nistp256</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>hmac-md5</code>​ (廃止)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>diffie-hellman-group18-sha512</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ecdsa-sha2-nistp384</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>hmac-md5-96</code>​ (廃止)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>diffie-hellman-group17-sha512</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ecdsa-sha2-nistp521</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>hmac-sha1-96</code>​ (廃止)</p></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>diffie-hellman-group16-sha512</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ssh-ed25519</code>​**</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>diffie-hellman-group15-sha512</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>sk-ecdsa-sha2-nistp256@openssh.com</code></p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>diffie-hellman-group14-sha256</code></p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>sk-ssh-ed25519@openssh.com</code>​**</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>diffie-hellman-group1-sha1</code>​ (廃止)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>rsa-sha2-512</code></p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>diffie-hellman-group14-sha1</code>​ (廃止)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>rsa-sha2-256</code></p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>diffie-hellman-group-exchange-sha1</code>​ (廃止)</p></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ssh-rsa</code></p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ssh-dss</code>​ (廃止)</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ssh-dss-cert-v01@openssh.com</code>​ (廃止)</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
<tr>
<td class="tableblock halign-left valign-top"></td>
<td class="tableblock halign-left valign-top"><p class="tableblock"><code>ssh-rsa-cert-v01@openssh.com</code>​ (廃止)</p></td>
<td class="tableblock halign-left valign-top"></td>
</tr>
</tbody>
</table>

`*`​ これらのアルゴリズムには Java 11 より前の Java バージョンの Bouncy Castle が必要です。  

`**`​ これらのアルゴリズムには外部 EdDSA (Edwards-curve Digital Signature Algorithm) ライブラリが必要です。

## [](#トラブルシューティング)トラブルシューティング

### [](#アップグレードの取り消し)アップグレードの取り消し

以前のバージョンの SFTP Connector に戻す必要がある場合、Anypoint Studio に移動し、プロジェクトの ​`pom.xml`​ ファイルで、​`mule-sftp-connector`​ 連動関係バージョンを 2.x.x から以前のバージョンに変更します。

### [](#ssh-接続セキュリティ設定の上書き)SSH 接続セキュリティ設定の上書き

サポートされていない暗号化、macs、hostKeyAlgorithms、または kexAlgorithms が原因で SSH 接続の問題が発生した場合は、優先度を変更するか、非推奨になった暗号化やアルゴリズムを強制的に有効にしてください。ただし、この方法を使用するとリスクが高まる場合があります。​[「SSH 接続のセキュリティパラメーターの設定」](https://docs.mulesoft.com/jp/sftp-connector/2.2/sftp-security-configuration-override)​および​[「SFTP Connector リファレンス」](https://docs.mulesoft.com/jp/sftp-connector/2.2/sftp-documentation)​を参照してください。

## [](#関連情報)関連情報

- [Anypoint Connector の概要](https://docs.mulesoft.com/connectors/introduction/introduction-to-anypoint-connectors)
- [MuleSoft ヘルプセンター](https://help.mulesoft.com)