> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ones1ght.com/llms.txt
> Use this file to discover all available pages before exploring further.

# SFTP 接続

> SFTPサーバーにある大容量ファイルを直接読み込めるように接続しましょう

## SFTP接続とは？

ブラウザでのアップロードが難しい大容量ファイルをSFTPサーバーに置くと、OneS1ghtが参照時にそのファイルを直接読み込みます。ファイルはコピーして保管されないため、元のファイルを差し替えると次回の参照から即座に反映されます。

通信区間はSSHで暗号化されます。暗号化されない通常のFTPはサポートしていません。

> [!NOTE]
>
> データソースの登録は\*\*管理者（Admin）\*\*権限を持つユーザーのみ行えます。サーバーアカウントの発行（ステップ1）は、該当サーバーを管理する担当者が行う必要があります。

## 準備するもの

* サーバーの**アドレス**と**ポート**（デフォルト`22`）
* **読み取り専用**アカウントと、そのアカウントの**パスワード**または**SSH秘密鍵**
* 読み込むファイルがある**パス**

## ステップ1: 読み取り専用アカウントの準備（サーバー）

OneS1ghtはファイルの**一覧取得**と**読み込み**のみを行います。ファイルのアップロードや削除は行わないため、書き込み権限のないアカウントを使用してください。

**1. 専用アカウントを作成**

OneS1ght接続専用のアカウントを別途作成します。他の用途と共有しないことで、後から権限を回収しやすくなります。

**2. 必要なパスのみ開放**

データファイルがあるディレクトリにのみ読み取り権限を付与します。可能であれば、そのディレクトリの外に出られないよう制限（chrootなど）することを推奨します。

**3. 認証方式を決定**

パスワードまたはSSH秘密鍵のいずれかを使用します。セキュリティ上、**SSH秘密鍵方式を推奨します**。

> [!WARNING]
>
> SSH秘密鍵を使用する場合は、**パスフレーズ（暗号）が設定されていない鍵**である必要があります。パスフレーズが設定された鍵は接続できず、原因は表示されずに認証失敗としてのみ表示されます。

## ステップ2: OneS1ghtに接続

**1. ストレージを選択**

**データソース → 追加 → ストレージ → SFTP**を選択します。

**2. 接続情報を入力して接続**

以下の項目を入力し、接続を確認します。

| 項目 | 説明 |
| - | - |
| ホスト | サーバーアドレス |
| ポート | デフォルト`22` |
| ユーザー | ステップ1で作成したアカウント |
| 認証方式 | パスワードまたはSSH秘密鍵 |
| パスワード / 秘密鍵 | 秘密鍵はファイル内容全体を貼り付けます |

入力したパスワードと秘密鍵は登録時に**AES-256-GCM方式で暗号化されて保存**され、画面に再表示されることはありません。

**3. ファイルを選択**

フォルダをクリックして移動し、使用するファイルを選択します。SQLite（`.db`）ファイルの場合は、続けて参照する**テーブル**を選びます。

**4. 確認して登録**

プレビューでデータを確認し、自動で提案されたマッピングを確認したうえで、名前を指定して登録します。

## 接続できないとき

> **サーバーが社内ネットワーク・VPN内にあります**
>
> サーバーは**外部から接続できるアドレス**である必要があります。社内ネットワークやVPN内でのみ開かれているアドレスは、セキュリティポリシーによりブロックされます。この場合は、担当者と協力して外部接続経路を用意する必要があります。

> **ファイアウォールでIPを制限しています**
>
> サーバーが特定のIPのみ許可するよう設定されている場合、OneS1ghtサーバーのアドレスを許可リストに追加する必要があります。許可すべきIPは[お問い合わせ](/ja/console/inquiries)からご依頼ください。

> **秘密鍵を入力しても認証に失敗します**
>
> 鍵にパスフレーズが設定されていないか確認してください。パスフレーズが設定された鍵はサポートしていません。また、秘密鍵はヘッダーとフッターを含め**ファイル内容全体**を貼り付ける必要があります。

## 対応ファイル形式とサイズ制限

| 形式 | サイズ制限 |
| - | - |
| CSV | 制限なし — ファイルの先頭4MBまで読み込みます |
| Excel（`.xlsx`、`.xls`） | 32MB |
| JSON | 32MB |
| SQLite（`.db`） | 256MB |

Excel・JSON・SQLiteは形式の特性上、ファイル全体を取得しないと開けないためサイズ制限があります。制限を超えると、登録ステップで案内メッセージが表示されます。

## 次のステップ

> **[Amazon S3 接続](/ja/console/data-sources/s3)**
>
> S3およびS3互換ストレージを接続します

> **[お問い合わせ](/ja/console/inquiries)**
>
> 接続できない場合はお問い合わせください


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.