SpectaShellのアイコン SpectaShell · セキュリティ

セキュリティ

シェルはサーバーに、鍵はデバイスに。

SpectaShellは、SSHクライアントと、サーバー上でシェルを保持する小さなプログラムkeeperでできています。サーバーには自分のSSHログインでのみ入り、ポートは開けず、rootも使いません。秘密鍵は、それを作ったデバイスから出ません。Calida Labのサーバーがターミナルの中身を見ることはありません。私たちが運用するサーバーは通知リレーひとつだけで、通知はサーバー側でHPKEにより封をされ、開けられるのは自分のデバイスだけです。このページでは、それぞれが具体的に何を意味するのかを、自分で確かめる方法とあわせて説明します。

SpectaShellがすること

  • 自分のSSHログインでサーバーに接続する
  • 許可したサーバーにだけ、~/.local/share/spectashellにkeeperを置く
  • authorized_keysにデバイスの公開鍵を追加する(コメントはSpectaShellで始まる)
  • ホスト一覧などの設定を、自分のiCloudのプライベートデータベースに同期する
  • 通知をオンにした場合だけ、封をした通知をリレーへ送る

しないこと

  • サーバーやデバイスでポートを開く
  • rootやsudoを使う、システムサービスをインストールする
  • .bashrcや.zshrcなどのシェル設定ファイルを書き換える
  • パスワードを保存する、秘密鍵やパスワードを送信する
  • 利用統計、アナリティクス、トラッキング
01 · keeper

サーバーで動くもの:spectashell-keeper

SSHで開いたシェルはその接続の子プロセスなので、接続が切れるとSIGHUPを受け、中で動いていた処理も一緒に終わります。tmuxやscreenはこれをサーバー側のプロセスで解決します。SpectaShellも同じ考え方で、シェルごとにspectashell-keeperのプロセスを1つ起動し、その中でシェルを動かします。keeperがPTYと直近の出力を持っているので、接続が切れても、デバイスがスリープしても、アプリを終了しても、シェルは動き続けます。つなぎ直せば、画面もそのまま戻ります。

自分のMac、iPad、iPhone

  • SpectaShell
  • Secure Enclave内のデバイス鍵
→ssh user@host

自分のサーバー、自分のアカウントで

  • sshd → spectashell-keeper attach
  • keeper → シェル(PTY)
  • Unixソケット、0700のディレクトリ内
  • ネットワークポートなし、rootなし
02 · 一覧用の鍵

Face IDなしで、シェルの一覧だけを見る鍵

デバイス鍵は、ログインのたびにFace IDを求めます。一方で、アプリの「Running」画面は、各サーバーでどのシェルが動いているかを頻繁に確かめる必要があります。そこで各デバイスは、確認なしで署名する2つ目の鍵、一覧用の鍵(listing key)を持っています。この鍵でできるのはkeeperの一覧を取得することだけで、その制限はアプリではなく、サーバーのsshdが強制します。

一覧用の鍵の、~/.ssh/authorized_keysの行。restrictがPTYの割り当てと、ポート・エージェント・X11のフォワーディングをすべて無効にし、command=によって、クライアントが何を要求してもこのコマンドしか実行されません。シェルもファイル転送も開きません。
restrict,command="$HOME/.local/share/spectashell/current/spectashell-keeper list" ecdsa-sha2-nistp256 AAAA… SpectaShell listing on iPhone
漏えいするアカウントが、
そもそもない。

サインアップも、ログインも、パスワードのデータベースもありません。

同期とチーム共有には、デバイスにサインイン済みのApple AccountのiCloudを使います。Calida Labの手元には、ユーザーのアカウントも、ホスト一覧も、鍵もありません。唯一運用している通知リレーが持っているのは、デバイスの通知トークンとホストの公開鍵だけです。

03 · keeperの検証

自分のサーバーで動くバイナリを確かめる

04 · 鍵と認証

秘密鍵はチップの中に、パスワードはどこにも残さない

デバイス鍵

鍵は、各デバイスが自分で作ります。iPhone、iPad、AppleシリコンまたはT2チップを搭載したMacでは、Secure Enclaveの中でECDSA P-256の鍵として作られ、秘密鍵を取り出す方法はありません。SpectaShellにも、デバイスを手にした人にもできません。Secure EnclaveのないMacでは、同期しない設定のキーチェーン項目に、Ed25519の鍵として置きます。サーバーが鍵を受け入れるたびに、Face ID、Touch ID、またはデバイスのパスコードやパスワードで確認してから署名します。外部の鍵をインポートする機能はありません。

確認を求めるエージェントフォワーディング

サーバーでエージェントフォワーディングをオンにすると、そのサーバーがほかの場所にログインしたり、gitのコミットに署名したりするときに、デバイス鍵を使えるようになります。署名のリクエストごとに、どのサーバーが何のために使うのかを表示して、個別にFace IDやTouch IDで確認します。別のリクエストへの承認を使い回すことはありません。一度キャンセルすると、その接続からのリクエストはそれ以降受け付けません。フォワードされたエージェント経由で、鍵を追加・削除することもできません。

Macの~/.sshは読むだけ

Macでは、~/.ssh/config、~/.sshにある鍵、SSHエージェント、known_hostsを、sshと同じように読み込みます。書き換えも、コピーも、アップロードもしません。ただし、MacのSSHエージェントの鍵は、sshと同じく確認なしでフォワードされます。フォワーディングは、信頼できるサーバーでだけオンにしてください。

パスワードは保存しない

パスワード、パスフレーズ、ワンタイムコードは、必要なときにたずねてログインに渡し、すぐに忘れます。ダイアログにも「Not stored anywhere」と書いてあります。入力欄はシステムの自動入力に対応しているので、「パスワード」アプリや1Passwordがパスワードとワンタイムコードを入力できます。保管するのはそのパスワードマネージャーで、SpectaShellではありません。パスワードで一度ログインすると、デバイス鍵をサーバーに追加するよう提案するので、次からは鍵でログインできます。

ホスト鍵の検証

OpenSSHと同じ方式です。初めて接続するときに鍵の種類とフィンガープリントを表示し、信頼するかを確認します。信頼した鍵は、ほかのデバイスにも同期されます。鍵が変わっていれば、すべてのデバイスで接続を拒否し、「Forget Old Key…」で意図して古い鍵を忘れたときにだけ、新しい鍵を受け入れます。Macでは、既存の~/.ssh/known_hostsにあるホストも、そのまま信頼します。

デバイスをなくしたとき

別のデバイスで「Keys」を開き、なくしたデバイスの横にある「Remove from Every Host…」を選ぶと、ホスト一覧のすべてのサーバーに接続して、そのデバイスの鍵を削除します。そのとき接続できなかったサーバーからは、次に自分のデバイスがログインしたときに削除します。その鍵が再びサーバーに置かれることはなく、そのデバイスへの通知も止まります。

05 · 通知リレー

私たちのサーバーはひとつ。そこから見えないもの

サーバーのエージェントが承認を待っているのに、どのデバイスもそのシェルを見ていない。そんなとき、keeperはiPhoneに通知を送れます(「Settings ▸ Notifications ▸ Notify This Device」)。ただ、Appleは、アプリのプッシュ用の鍵を持つ側からしか通知を配信しません。その鍵をユーザーのサーバーごとに配るわけにはいかないので、間にCalida Labのリレー(push.calidalab.ai)を置いています。リレーは、通知の中身を読めないように設計しています。

自分のサーバーのkeeper

  • デバイスの公開鍵で通知に封をする
  • ホスト固有のEd25519鍵でリクエストに署名
→HTTPS

リレー → APNs

  • 署名を確かめ、封をされたバイト列をそのまま転送
  • 中身は保存しない
→APNs

自分のiPhone

  • デバイスの秘密鍵で開封
  • ホスト名はデバイス自身の記録から

リレーが知っていること

  • デバイスの通知トークン
  • そのデバイスに通知を送るホストの公開鍵(つまり、ホストの数)
  • ホストごとの、送信のタイミングと頻度
  • すべて同じサイズの、封をされたバイト列
  • リクエストのIPアドレス。記録はしません。前段のCloudflareにも同じものが見えます。

リレーが決して知らないこと

  • 通知の内容
  • どのサーバーか(名前、アドレス)
  • 実行したコマンドや、シェルに出力された内容
  • どんなファイルも
  • 署名や開封に使う秘密鍵の、どれひとつ
06 · データ

同期されるもの、デバイスに残るもの

自分のiCloudのプライベートデータベースに同期

  • ホストとグループ、スニペット、トリガー
  • 保存したポートフォワーディング、お気に入りのフォルダ
  • 追加したクラウド(認証情報を除く)
  • 信頼したホスト鍵、自分のデバイスの公開鍵
  • ターミナルのフォントとテーマ
  • 通知のルール、通知に使うホストの公開鍵

デバイスの外に出ないもの

  • 秘密鍵(デバイス鍵、一覧用の鍵)
  • パスワード、パスフレーズ、ワンタイムコード(そもそも保存しない)
  • シェルの出力
  • コマンド履歴(トークンが含まれうるので、このデバイスにだけ30日間)
  • ウィンドウやタブ、文字サイズなど、このデバイスだけの設定
07 · ネットワーク

SpectaShellが接続する先、そのすべて

08 · サーバーに残るもの

インストールされたものを確かめ、削除する

SpectaShellがサーバーに置くものは、以下がすべてです。サーバーのほかの場所には触れません。

SpectaShellがサーバーに置くもの。削除する前に、そのサーバーのシェルをすべて閉じてください。
~/.local/share/spectashell/           # keeperのバイナリ(ビルドごとのディレクトリ)とシェル統合のスクリプト
~/.local/share/spectashell-push/      # 通知をオンにした場合のみ:受け取るデバイスごとにファイル1つ
/tmp/spectashell-$(id -u)/            # Linux:keeperのソケットとメタデータ
~/Library/Application Support/SpectaShell/keepers/   # Macサーバー:同上
~/.ssh/authorized_keys                # コメントが"SpectaShell"(初期のビルドでは"sdTerm")で始まる行
09 · よくある質問

セキュリティQ&A

Calida Labは、自分のシェルやサーバーの一覧、鍵を見られますか?

いいえ。シェルは自分のデバイスとサーバーの間のSSHの中だけを通り、同期データは自分のiCloudのプライベートデータベースにあり、秘密鍵とパスワードはデバイスの外に出ません。利用データも送らず、アナリティクスもありません。Calida Labのサーバーを通るのは、通知をオンにしたときにリレーを経由する封をされた通知だけで、それを開ける鍵は自分のデバイスにしかありません。

サーバーでポートを開けたり、rootが必要になったりしますか?

どちらもありません。keeperは自分のアカウントとしてホームディレクトリから動き、0700のディレクトリにあるUnixソケットだけを使います。入口は自分のSSHログインだけで、システム全体にインストールするものはありません。

同じサーバーのほかのユーザーが、自分のシェルに入れますか?

ほかの一般ユーザーは入れません。自分のアカウントとrootは入れます。tmuxやscreenと同じです。管理者を信頼できないサーバーでは、シェルに秘密情報を置かないでください。

エージェントフォワーディングをオンにしても大丈夫ですか?

SSHのエージェントフォワーディングは、プロトコルの性質上、そのサーバーのrootもフォワードされたエージェントを使えます。SpectaShellはデバイス鍵を使うたびにFace IDやTouch IDで個別に確認するので、知らないうちに使われることはありません。サーバーが鍵を追加・削除することもできません。ただし、MacのSSHエージェントの鍵は、sshと同じく確認なしで渡ります。信頼できるサーバーでだけオンにしてください。

Apple Accountが乗っ取られたら、どうなりますか?

同期しているホスト一覧とスニペットは見られてしまいます。ただし、鍵とパスワードは同期しないので、サーバーにはログインできません。新しいデバイスの一覧用の鍵も、既存のデバイスが承認するまではサーバーに置かれません。スニペットにはパスワードやトークンを入れないでください。

チームでグループを共有すると、何が共有されますか?

グループの共有はApple Account同士のCloudKit共有で、やり取りされるのはサーバーの名前とアドレスだけです。開けるのは招待した人だけです(リンクを知っている誰でも参加できるよう、自分で設定した場合を除きます)。鍵やパスワードは共有されず、共有しただけでは誰もログインできません。誰がログインできるかは、サーバーのauthorized_keysが決めます。メンバーはそれぞれ自分のデバイス鍵を使い、そのサーバーにログインできる人に「Who May Log In…」で入れてもらいます。メンバーを自分のアカウントに入れると、そのアカウントのシェルをすべて見て操作できるので、人ごとに別のアカウントを用意してください。

Macアプリがサンドボックス化されていないのはなぜですか?

Macで開くローカルシェルは自分のファイルにアクセスする必要がありますが、サンドボックス化されたアプリのシェルにはそれができないからです。そのため、iTerm2やGhosttyと同じように、Developer IDで署名し、Appleの公証を受けて直接配布しています。iPadとiPhoneのアプリはApp Storeのアプリなので、サンドボックスの中で動きます。ローカルシェルは持たず、サーバーのシェルだけを開きます。

iPhoneをなくしました。

別のデバイスで「Keys」を開き、なくしたデバイスの横にある「Remove from Every Host…」を選んでください。すべてのサーバーからそのデバイスの鍵を削除し、そのデバイスへの通知も止めます。あわせて、「探す」でデバイスを消去し、Apple Accountからも削除してください。

サーバーからSpectaShellを完全に削除するには?

そのサーバーのシェルをすべて閉じてから、08 · サーバーに残るものにあるディレクトリを削除し、~/.ssh/authorized_keysから、コメントがSpectaShell(初期のビルドではsdTerm)で始まる行を削除してください。

セキュリティ上の問題の報告
戻る概要 → Mac版ベータをダウンロードiPad・iPhoneのベータに参加無料 · macOS 15、iPadOS 18、iOS 18以降