デスクトップ受信機

はじめる前に

受信中も電源が入っている、Windows または Linux のパソコンが必要です。事業者のサインインとオンサイトモードには Business プランが必要です。個人モードは、ご自身のスマートフォンのペアリングリンクでペアリングでき、アカウントは不要です。

手順

• Windows のインストーラー（NSIS）か、Linux の AppImage または deb をダウンロードページから入手し、すぐ横に公開されている SHA-256 の値を確認します。ビルドは今のところ署名されていないため、オペレーティングシステムから一度警告が出ます。Windows では SmartScreen が「Windows によって PC が保護されました」と表示するので、「詳細情報」をクリックしてから「実行」をクリックします。インストーラーは管理者権限を一度だけ求め、このパソコンのすべてのユーザー向けにインストールし、プライベート、パブリック、ドメインの各ネットワークでこのアプリ用にファイアウォールを開けます。Ubuntu 24.04 では、AppImage は --no-sandbox を付けて実行する（./WhispShare-Receiver-…AppImage --no-sandbox）まで起動しません。Chromium に必要なサンドボックスを Ubuntu 24.04 が制限しているためです。deb パッケージならその設定を行うので、そのまま通常どおり起動します。
• このパソコンの受信方法を選びます。事業者のサインイン（オーナーがブラウザーで承認する 8 文字の端末コード）、個人モード（「スマートフォンとペア」。ご自身のスマートフォンのペアリングリンクを使います）、またはオンサイトのみ（インターネットのないこの Wi-Fi で来店したお客様向け）のいずれかです。個人モードでは、ブラウザーを開いていなくても、このパソコンがスマートフォンからの受信を続けます。スマートフォンで WhispShare を開いてペアを開始し、ペアリングリンクをこのパソコンに送ります（メールや自分へのメモで）。それを「スマートフォンとペア」の画面に貼り付け、「スマートフォンとペア」を押してください（何かがペアリングされるまで、トレイメニューにも同じ項目があります）。ファイルを送るときは、スマートフォンとパソコンの両方がオンラインである必要があります。このパソコンは、あなたのスマートフォンが開始するペアの相手側として待機します。自分の QR コードは表示しません。
• 保存フォルダを選びます。各セッションは専用のフォルダに入ります: <保存フォルダ>/<年月>/<リンクのラベル、ルーム名、または「Direct」>/<日時> <送信者名または「Visitor」> <セッションコードの末尾4文字>/。各ファイルのすぐ横にはサイドカーファイル <ファイル>.whispshare.json ができます。サイドカーには、セッション、送信者の名前と端末、リンクとそのラベル、送られたときと保存されたときのファイル名、サイズ、種類、SHA-256 が記録され、転送が終わると検証済みのセグメントハッシュも加わります。送信者が送るテキストやカードはサイドカーには入りません。受信機が日次ログ（保存フォルダの received-<date>.jsonl）に保管します。
• 受信機は動かしたままにします。トレイに常駐し、コンピューターの起動と一緒に始めることもできます。トレイメニューには、受信機が今何をしているかが言葉で表示されます（スマートフォンから受信中、事業のために受信中、一時停止中、オフライン、管理者の受信箱キーを待機中、まだペアになっていない）。また、「保存先フォルダーを変更」と「保存先フォルダーを開く」が常に表示されます。同じ 2 つのボタンはウィンドウの下部にもあります。受信機はコンピューターの言語に従い（英語、アラビア語、ドイツ語、スペイン語、フランス語、ヘブライ語、イタリア語、日本語、韓国語、オランダ語、ポーランド語、ブラジル系ポルトガル語、ルーマニア語、トルコ語、中国語）、トレイメニューまたは設定で別の言語を選ぶこともできます。
• ルームの共有を集めるには「ルームに参加」を使います。受信機はルームに受信専用で居て、メンバーが共有したものを保存します。
• このコンピューターの受信を止めるには、事業の設定から受信機を取り消すか、コンピューター自体の設定で「この端末のペアリングを解除」を選んでください。ペアを解除すると、受信機の枠がサーバー上で受信機自身の端末トークンを使って解放され、その後コンピューターからトークン、ペア、ルーム、受信箱キーが削除されます。サーバーに接続できない場合、コンピューターはペアが解除されていますが、ウィンドウにはサーバーが解放を確認しなかったと表示されます。その場合は、管理者に事業コンソールで受信機を削除するよう依頼してください。そうしないと、その枠は引き続き数えられます。

鍵の保存場所

受信機の ID と受信箱の鍵は、受信機の状態フォルダー内にある鍵で暗号化されています。デスクトップアプリは、その鍵をオペレーティングシステムの安全な保管領域（Windows の資格情報マネージャーの DPAPI、macOS のキーチェーン、または libsecret か KWallet 経由の Linux キーリング）で保護します。この鍵は、このパソコンとこのユーザーアカウントに、OS の鍵ストアを通じて結び付けられています。そのため、バックアップ、同期クライアント、ディスクイメージから取った状態フォルダーのコピーだけでは、鍵は一緒に移りません。About 画面で鍵の保存方法を確認できます。キーリングのないLinuxパソコンでは、鍵は保護されたファイル（モード 0600）に保存され、About 画面にそのことが表示されます。保護するには gnome-keyring か KWallet をインストールしてください。ログイン直後にキーリングがまだロックされている場合、受信機は約 30 秒待ちます。後で鍵を開けない場合（キーリングまたはアカウントがリセットされた場合）は、終了するか、やり直してペアリングし直すかを提示します。鍵を新しく黙って作ることは決してありません。ヘッドレス受信機（whispshare-receiver）には OS の鍵ストアがないため、その状態フォルダー（<folder>/.whispshare/）そのものが鍵になります。このフォルダーをコピーできる人は、受信機が読むものを読めます。このフォルダーはバックアップ、同期クライアント、共有ドライブから外し、サービスアカウントだけが読めるようにしてください（モード 0700）。受信機を別のマシンに移すには、新しい受信機をペアリングしてください。whispshare-receiver --help にも同じことが書かれています。

相手側に見えるもの

お客様には、受信機が動いている間、ビジネスが「受信中」と表示されます。お客様はリクエストカードを1枚送ってノックし、人または待機中の端末が確認してはじめて、ファイルをライブで送れます。受信機自体は、誰もルームに入れず、ルームの許可も送りません。保存するだけです。「受信を一時停止」を使うと、ドアベル、ルーム、個人のペアリングがまとめて閉じます。すでに動いている転送は最後まで続き、新しい申し出は再開するまで待ちます。

うまくいかないとき

オフの受信機は受信していません。リンクのページにもそう表示され、待てるのはリクエストカード1枚だけです。オンサイトモードでは、ゲストのブラウザーにローカルアドレスへの証明書の警告が出ます。インターネットのないネットワークではその警告は想定どおりなので、そのことをはっきり伝え、ゲストに会場のカードを見せて照合してもらってください。保存フォルダがいっぱいになったり移動したりしたら、新しいフォルダを選んで、もう一度受信します。空き容量より大きい転送は、始まる前に辞退されます。スマートフォンからオンサイトのアドレスに届かないときは、オンサイトパネルを開いてください。パネルには、Windows がこのパソコンを置いているネットワークが表示され、ファイアウォールの規則がない、またはそのネットワークを対象にしていない場合は、そう知らせます（Windows のプロンプトでは「パブリック ネットワーク」にチェックを入れるか、すべてのユーザー向けに再インストールします）。パソコンに複数のアドレスがある場合（Wi-Fi、VPN、WSL、Docker）は、そこでQRコード用に Wi-Fi のものを選びます。問題を報告するときは、設定、バージョン情報、診断情報をコピーの順に開き、その文章をメッセージに貼り付けてください。含まれるのはバージョン、状態、件数だけで、ファイル名、鍵、アドレスは入りません。受信機は、同じ種類の小さなローテーションログも、オペレーティングシステムのログフォルダに残します。

上限

受信機はライブ転送のサイズ上限を引き上げます。個人モードでは 2 GiB、Away は 20 GiB、Business は 50 GiB で、ブラウザーは 2 GiB、iPhone は 1 GiB のままです。テンプレートの上限は、確認済みのセッションにも引き続き適用されます。書類は 10 ファイルと 50 MB まで、確認は 1 ファイルと 500 MB までです。ただし、リンクが独自の上限を設定している場合を除きます。受信機は1日に1回、新しいバージョンを確認してバナーを表示します。ダウンロードページから手動でダウンロードしてインストールしてください。ヘッドレス受信機（whispshare-receiver）は、受け取った各ファイルをローカルの Webhook に POST できます。このパソコンまたは社内ネットワークだけで使ってください。POST には、保存先のパス、ファイル、送信者が含まれます。シークレット（--webhook-secret）を設定すると、POST に HMAC 署名が付き、失敗した POST は3回再試行されます。

関連

• Business: 共有の受信ボックス
• ダウンロード
• インターネットなしで共有