Reverse SSHとDockerごとにNASを独自ストレージとして接続する(QNAPの例)

概要

Reverse SSHでは、お客様のNASがPaperOfficeへの発信暗号化接続(トンネル)を自ら確立します。ルーターでのポート開放は不要です。PaperOffice AIはWorkspacesの暗号化された文書をお客様のNASに保存します。

Workspaceを作成する前にストレージを作成してください。Workspacesのストレージモードは作成後に変更できません。

ステップ1:NASの準備(QNAPの例)

QTSのメニューはQTSのバージョンによって若干異なる場合があります。

  1. 専用の共有フォルダーを作成します。例:paperoffice。PaperOffice ClassicやMariaDBのフォルダーは使用しないでください。
  2. コントロールパネル › ネットワーク&ファイルサービス › Telnet / SSHで、SSHとSFTPを有効にします。
  3. そこで「アクセス権限の編集」に、ログインに使用するNASユーザーを追加します。このリストにユーザーがいない場合、NASはSSHログインを拒否します。
  4. Container Station(Docker)をインストールします。提案されたコンテナ用共有フォルダーはそのまま使用できます。

Synology:Container Manager、ユーザーホームサービスを有効にし、ユーザーをadministratorsグループに追加します。ASUSTOR:Docker Engine。UGREEN:Docker。

ステップ2:PaperOffice AIでストレージを作成する

  1. Document AI › Storage Mountsを開き、Storage Mount を追加をクリックします。
  2. 赤いアスタリスク(*)の付いた項目は必須項目です。
  3. この Storage Mount の名前:自由に選択できます。
  4. 振込名義:BYOS-Storageとして使用。
  5. 接続タイプ:リバースSSHでローカルフォルダに接続。
  6. お客様のNAS:QNAPを選択します。アプリが/share/paperofficeを提案します(Synology、ASUSTOR、UGREEN:/volume1/paperoffice)。
  7. ローカルSSHユーザー:NASでのユーザー名です。管理者グループのメンバーである必要があります。
  8. ローカルフォルダ:フォルダーへのフルパス。QNAPでは/share/<Name des Freigabeordners>です。引用符、バックスラッシュ、* ? [ ]は使用しないでください。フォルダーとユーザーは後から変更できません。
  9. 暗号化パスワードとパスワードの確認:16文字以上、または安全なパスワードを生成(鍵アイコン)。
  10. .txtとしてダウンロードをクリックします。その後でないとストレージを作成できません。ファイルは安全な場所に保管してください。パスワードがないと復元できません。
  11. 確認のチェックボックスをオンにして保存します。

ステップ3:適切なセットアップブロックを選択する

保存後、リバースSSHセットアップウィンドウがトンネルエイリアスとともに開きます。上部でバリエーションを選択してください:

  • Docker対応NAS: 小さなトンネルコンテナを起動するブロック。Container Station搭載のQNAPにとって適切な選択です。
  • Dockerを使用しないNAS: ブロック1をSSH経由で、ブロック2を自動起動に設定します。
  • Linux / macOSおよびWindows: パソコン向けです。

セットアップをコピーを使用してブロックをコピーしてください。Dockerを使用しないNASの場合、各ブロックに専用のボタンが用意されています。

ステップ4: NASでログインし、ブロックを貼り付ける

Windowsの場合は、PuTTYなどを使用します(バージョンにより表記が若干異なる場合があります):

  1. 「Host」欄に、ローカルネットワーク内のNASのIPアドレスを入力し、ポート22で接続を開きます。
  2. ステップ2で設定したNASユーザーでログインしてください。パスワード入力時は文字が表示されませんが、これは正常な動作です。
  3. QNAPがログイン後にコンソールメニュー(例:「Console Management」)を表示する場合があります。通常のコマンドラインに戻るため、QTSのバージョンに応じてQおよびその後Yを押してください。
  4. ウィンドウ内で右クリックするとブロックが貼り付けられます。その後、Enterキーを押してください。

Macの場合:ターミナルアプリを開き、次にssh <Benutzer>@<IP-Adresse des NAS>を実行してください。

ブロックはNASにあるこのウィンドウにのみ配置してください。NASにはインターネット接続が必要です。トンネルはお客様のNASから外部に向けて構築され、コンテナ起動時に小さなLinuxパッケージが読み込まれます。

ステップ5:接続テスト

  1. Storage Mountsのストレージを編集で開きます。
  2. 接続テストをクリックします(保存後に有効になります)。
  3. 成功のメッセージ:「トンネル有効:NASに到達可能、フォルダは書き込み可。」その後、独自のストレージ(BYOS)を使用してWorkspaceを作成してください。

テストでログインが拒否された場合は、ステップ1で確認したNASユーザーとアクセスリストを確認してください。その後、登録されているNASユーザーとして再度エントリを追加し、テストを再実行してください。

トレースが示す内容

一覧で 接続テスト を起動すると、PaperOffice のトレースが地図付きで開始されます。Reverse SSH では、ターゲットは PaperOffice のトンネルサーバーであり、お客様の NAS ではありません。場所の表示は、この経路上のネットワークノードを示しており、お客様のファイルの保存場所ではありません。

リブート後

トンネルコンテナは、Docker が稼働している状態になると、リブート後に自動的に起動します。接続が切断された場合は、10秒後に再接続を試みます。Docker がない場合、自動起動のブロック 2 が対応します。

セキュリティ:セットアップブロックには秘密鍵が含まれています

このブロックには秘密鍵が含まれており、お客様の NAS ユーザーのログインキーとして登録されます。このブロックを所持している者は、お客様のトンネルになりすまし、SSH サービスが利用可能な場所からお客様の NAS ユーザーとしてログインできます。暗号化パスワードはブロック内には含まれていません。

  • チャンネル、AI アシスタント、メール、サポートチケットにこのブロックを絶対に貼り付けないでください。
  • サポートはこのブロックを必要としません。代わりにテストのエラーメッセージをお知らせください。

Wenn es doch passiert ist:

  1. 可能な限りメッセージを削除してください。
  2. 「キーの再生成」ボタンは存在しません。編集してもキーは変更されません。
  3. Workspace がストレージを使用していない場合:Storage Mount を削除してください。これにより、PaperOffice はトンネルサーバーからキーが解除されますが、NAS 上のファイルは保持されます。同じ暗号化パスワードまたは空のフォルダを使用して、ストレージを再作成してください(新しいキー、新しいトンネルエイリアス)。
  4. NAS から古いキーを削除してください:お客様の NAS ユーザーのフォルダ .ssh 内にある、authorized_keys の行で「PaperOffice」と古いトンネルエイリアスで終わるものを削除し、ファイル paperoffice_<alter Tunnel-Alias> を削除してください。Docker を使用している場合:お客様の Docker インターフェース(QNAP: Container Station)から、名前に paperoffice-tunnel- が付く古いコンテナを削除してください。Docker を使用していない場合:同じフォルダ .ssh 内のスクリプト paperoffice_tunnel_<alter Tunnel-Alias>.sh を削除し、自動起動から古いエントリを削除してください。
  5. Workspace がすでにストレージを使用している場合、そのストレージは削除できません。その場合は、アプリ内の サポート でチケットを作成し、キーが外部に漏れたことを記載してください。この際、ブロックを貼り付けないでください。

次へ