---
articleId: 9b131ee5-f1d2-4ad3-91ee-ea57f5bd09b1
slug: connection-configuration-sftp
title: 接続情報 - SFTP
parentCategoryId: 4db89ef6-4431-4a1f-a7c6-6c3b8a1a224c
languageCode: ja
---
本ページでは、SFTPに接続するための設定（接続情報）について説明します。
転送に関する設定については、[転送元 - SFTP](/docs/data-source-sftp)・[転送先 - SFTP](/docs/data-destination-sftp)を参照ください。

## 利用上の注意・制約

:::(Warning) (接続タイムアウト)

SFTPサーバーへの接続時に、接続タイムアウトが発生する場合があります。
接続タイムアウトが発生した場合は、SFTPサーバーの設定やネットワーク環境を確認してください。
:::

:::(Info) (SSHトンネル経由の接続)

SFTPサーバーに直接接続できない場合は、[SSHトンネル経由での接続](/docs/connection-with-ssh-tunnel)を利用できます。
:::

## 設定項目

|項目名|必須|説明|
|---|---|---|
|ホスト名|✓|SFTPサーバーのホスト名またはIPアドレスを入力します。|
|ポート番号|✓|SFTPサーバーのポート番号を入力します。<br>通常は`22`を指定します。|
|ユーザー名|✓|SFTPサーバーに接続するためのユーザー名を入力します。|
|パスワード|-|SFTPサーバーに接続するためのパスワードを入力します。<br>パスワード認証を使用する場合は必須です。|
|秘密鍵|-|SFTPサーバーに接続するための秘密鍵を入力します。<br>公開鍵認証を使用する場合は必須です。<br>秘密鍵は`PEM`形式の`PKCS#1`である必要があります。|
|秘密鍵のパスフレーズ|-|秘密鍵にパスフレーズが設定されている場合は入力します。<br>パスフレーズが設定されていない場合は空欄のままにします。|
|相対パスとして探索する|✓|チェックを入れると、ユーザーのホームディレクトリをルートディレクトリとして扱います。<br>デフォルトは有効（チェックあり）です。|
|Windowsサーバー|✓|チェックを入れると、接続先をWindowsサーバーとして扱います。<br>デフォルトは無効（チェックなし）です。|

## SFTP側で必要な作業

### SFTPサーバーの設定

SFTPサーバーに接続するには、以下の設定が必要です。

1. SFTPサーバーが稼働していることを確認します。
2. ファイアウォールの設定で、[TROCCOからSFTPサーバーへのアクセスが許可](/docs/global-ip-list)されていることを確認します。
3. SFTPサーバー上に、TROCCOからの接続に使用するユーザーアカウントが作成されていることを確認します。

### 権限の付与

SFTPサーバーに接続するユーザーには、適切な権限を付与する必要があります。

#### 転送元に利用する場合

SFTPサーバーからデータを取得するには、以下の権限が必要です。

- 対象ディレクトリの読み取り権限
- 対象ファイルの読み取り権限

#### 転送先に利用する場合

SFTPサーバーにデータを転送するには、以下の権限が必要です。

- 対象ディレクトリの読み取り権限
- 対象ディレクトリの書き込み権限
- 対象ファイルの読み取り権限
- 対象ファイルの書き込み権限

### 公開鍵の登録（公開鍵認証の場合）

公開鍵認証を使用する場合は、以下の手順でSFTPサーバーに公開鍵を登録します。

1. 秘密鍵と公開鍵のペアを生成します。
   ```
   ssh-keygen -t rsa -b 4096 -m PEM
   ```

2. 生成された公開鍵（`.pub`ファイル）をSFTPサーバーの`~/.ssh/authorized_keys`ファイルに追加します。
   ```
   cat id_rsa.pub >> ~/.ssh/authorized_keys
   ```

3. `authorized_keys`ファイルのパーミッションを適切に設定します。
   ```
   chmod 600 ~/.ssh/authorized_keys
   ```

4. `.ssh`ディレクトリのパーミッションを適切に設定します。
   ```
   chmod 700 ~/.ssh
   ```

5. TROCCOの接続情報設定で、生成した秘密鍵（`id_rsa`）の内容を入力します。

## 困ったときには・トラブルシューティング

### 接続に失敗する

#### 考えられる原因

- ホスト名やIPアドレスが間違っている
- ポート番号が間違っている
- ユーザー名やパスワードが間違っている
- 公開鍵認証の場合、秘密鍵やパスフレーズが間違っている
- ファイアウォールによってアクセスがブロックされている
- SFTPサーバーが稼働していない

#### 対処方法

- ホスト名、ポート番号、ユーザー名、パスワードが正しいか確認してください。
- 公開鍵認証の場合、秘密鍵が正しい形式（PEM形式）であるか確認してください。
- SFTPサーバーの管理者に、ファイアウォールの設定を確認してもらってください。
- SFTPサーバーが稼働しているか確認してください。

### 権限エラーが発生する

```text
Error: Permission denied
```

#### 考えられる原因

- ユーザーに必要な権限が付与されていない
- 対象のディレクトリやファイルのパーミッションが適切に設定されていない

#### 対処方法

- SFTPサーバーの管理者に、ユーザーに適切な権限が付与されているか確認してもらってください。
- 対象のディレクトリやファイルのパーミッションが適切に設定されているか確認してください。