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

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

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

<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.0.0</p>
</div></div></td>
</tr>
</tbody>
</table>

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

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

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

## [](#要件)要件

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

<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.0.0`​ であることを確認します。

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

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

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

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

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

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

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

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

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

<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>

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

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

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

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

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