> ## 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サーバーに置くと、OneSightが参照時にそのファイルを直接読み込みます。ファイルはコピーして保管されないため、元のファイルを差し替えると次回の参照から即座に反映されます。

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

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

## 準備するもの

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

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

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

<Steps>
  <Step title="専用アカウントを作成">
    OneSight接続専用のアカウントを別途作成します。他の用途と共有しないことで、後から権限を回収しやすくなります。
  </Step>

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

  <Step title="認証方式を決定">
    パスワードまたはSSH秘密鍵のいずれかを使用します。セキュリティ上、**SSH秘密鍵方式を推奨します**。
  </Step>
</Steps>

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

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

<Steps>
  <Step title="ストレージを選択">
    **データソース → 追加 → ストレージ → SFTP**を選択します。
  </Step>

  <Step title="接続情報を入力して接続">
    以下の項目を入力し、接続を確認します。

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

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

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

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

## 接続できないとき

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

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

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

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

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

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

## 次のステップ

<CardGroup cols={2}>
  <Card title="Amazon S3 接続" icon="database" href="/ja/data-sources/s3">
    S3およびS3互換ストレージを接続します
  </Card>

  <Card title="お問い合わせ" icon="message" href="/ja/support/tickets">
    接続できない場合はお問い合わせください
  </Card>
</CardGroup>