シェルはサーバーに、鍵はデバイスに。
SpectaShellは、SSHクライアントと、サーバー上でシェルを保持する小さなプログラムkeeperでできています。サーバーには自分のSSHログインでのみ入り、ポートは開けず、rootも使いません。秘密鍵は、それを作ったデバイスから出ません。Calida Labのサーバーがターミナルの中身を見ることはありません。私たちが運用するサーバーは通知リレーひとつだけで、通知はサーバー側でHPKEにより封をされ、開けられるのは自分のデバイスだけです。このページでは、それぞれが具体的に何を意味するのかを、自分で確かめる方法とあわせて説明します。
~/.local/share/spectashellにkeeperを置くauthorized_keysにデバイスの公開鍵を追加する(コメントはSpectaShellで始まる).bashrcや.zshrcなどのシェル設定ファイルを書き換えるSSHで開いたシェルはその接続の子プロセスなので、接続が切れるとSIGHUPを受け、中で動いていた処理も一緒に終わります。tmuxやscreenはこれをサーバー側のプロセスで解決します。SpectaShellも同じ考え方で、シェルごとにspectashell-keeperのプロセスを1つ起動し、その中でシェルを動かします。keeperがPTYと直近の出力を持っているので、接続が切れても、デバイスがスリープしても、アプリを終了しても、シェルは動き続けます。つなぎ直せば、画面もそのまま戻ります。
sshd → spectashell-keeper attach0700のディレクトリ内spectashell-keeper attachを実行し、このソケットにつなぎます。ファイアウォールの設定を変える必要はありません。外へ出ていく通信もしません。例外はひとつだけで、自分のデバイスで通知をオンにしている場合に、封をした通知をリレーへ送るHTTPSリクエストです(05 · 通知リレー)。/tmp/spectashell-<uid>/keepers、Macでは~/Library/Application Support/SpectaShell/keepersを使います。keeperは、それがシンボリックリンクではない実体のディレクトリであること、自分の所有であること、パーミッションが0700であることを確かめ、満たさなければ起動しません。別のユーザーが同じパスを先に作っておく攻撃も、ここで防げます。ソケット自体は0600です。$XDG_RUNTIME_DIRではなく/tmpを使う理由。$XDG_RUNTIME_DIRは最後のセッションがログアウトすると消えるため、切断後もシェルを残すという目的に合いません。tmuxが/tmp/tmux-<uid>を使うのと同じ理由です。その代わり、systemd-tmpfilesのような経過時間ベースの掃除で消されないよう、keeperは1時間ごとにソケット、メタデータファイル、ディレクトリのタイムスタンプを更新します。それでも消された場合は作り直すので、シェルにはこれまでどおり接続できます。Macは/tmpを定期的に掃除するため、Application Supportの下に置きます。~/.local/share/spectashell/の下のビルドごとのディレクトリに置きます。「Plain Shells」を選んだサーバーには何も置かず、普通のSSHで使います。.bashrc、.zshrc、fishの設定は書き換えません。TMUX、コーディングエージェントが子プロセスにつける目印のような変数は引き継ぎません。そのうえでTERM=xterm-256color、COLORTERM=truecolor、TERM_PROGRAM=sdTermを設定します。デバイス鍵は、ログインのたびに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 iPhoneauthorized_keysから行を削除するときは、コメントにあるデバイス名ではなく、鍵そのものを照合します。チーム共有で追加した行は、そのチームの印がついた行だけを扱います。自分で追加したほかの行には触れません。同期とチーム共有には、デバイスにサインイン済みのApple AccountのiCloudを使います。Calida Labの手元には、ユーザーのアカウントも、ホスト一覧も、鍵もありません。唯一運用している通知リレーが持っているのは、デバイスの通知トークンとホストの公開鍵だけです。
sha256sum ~/.local/share/spectashell/*/spectashell-keeperを実行すれば照合できます。鍵は、各デバイスが自分で作ります。iPhone、iPad、AppleシリコンまたはT2チップを搭載したMacでは、Secure Enclaveの中でECDSA P-256の鍵として作られ、秘密鍵を取り出す方法はありません。SpectaShellにも、デバイスを手にした人にもできません。Secure EnclaveのないMacでは、同期しない設定のキーチェーン項目に、Ed25519の鍵として置きます。サーバーが鍵を受け入れるたびに、Face ID、Touch ID、またはデバイスのパスコードやパスワードで確認してから署名します。外部の鍵をインポートする機能はありません。
サーバーでエージェントフォワーディングをオンにすると、そのサーバーがほかの場所にログインしたり、gitのコミットに署名したりするときに、デバイス鍵を使えるようになります。署名のリクエストごとに、どのサーバーが何のために使うのかを表示して、個別にFace IDやTouch IDで確認します。別のリクエストへの承認を使い回すことはありません。一度キャンセルすると、その接続からのリクエストはそれ以降受け付けません。フォワードされたエージェント経由で、鍵を追加・削除することもできません。
~/.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…」を選ぶと、ホスト一覧のすべてのサーバーに接続して、そのデバイスの鍵を削除します。そのとき接続できなかったサーバーからは、次に自分のデバイスがログインしたときに削除します。その鍵が再びサーバーに置かれることはなく、そのデバイスへの通知も止まります。
サーバーのエージェントが承認を待っているのに、どのデバイスもそのシェルを見ていない。そんなとき、keeperはiPhoneに通知を送れます(「Settings ▸ Notifications ▸ Notify This Device」)。ただ、Appleは、アプリのプッシュ用の鍵を持つ側からしか通知を配信しません。その鍵をユーザーのサーバーごとに配るわけにはいかないので、間にCalida Labのリレー(push.calidalab.ai)を置いています。リレーは、通知の中身を読めないように設計しています。
~/.local/share/spectashell-pushの下にファイルが1つでき、本人しか読めません。中身は、署名用の鍵(サーバー上で生成)と、封をするためのデバイスの公開鍵です。keeperは知らせることがあるときだけHTTPSで送り、何もlistenしない点は変わりません。0600。コマンド履歴や最後に同期した状態など、SpectaShellのファイルは本人しか読めません。push.calidalab.aiに接続するのは、通知をオンにしたデバイスと、そのデバイスに通知を送るサーバーだけです。www.calidalab.aiへアップデートの一覧(/spectashell/appcast.xml)を問い合わせます。リクエストに含まれるのはアプリ名とバージョンだけで、システムの情報は送りません。インストールするのは、SpectaShell専用の鍵で署名されたアップデートだけです。iPad・iPhoneのアプリは、App Storeでアップデートします。127.0.0.1で待ち受けるので、同じネットワークのほかの機器からは使えません。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")で始まる行authorized_keysの行は3種類です。パスワードでログインしたあとに「Add Key」で追加したデバイス鍵(SpectaShell on <デバイス>)、承認済みの自分のデバイスの一覧用の鍵(restrict,command=…で始まり、SpectaShell listing on <デバイス>で終わる行)、そして「Who May Log In…」で入れたチームメンバーの鍵です。デバイスの新しい鍵を追加すると、そのデバイスの以前の鍵の行はアプリが削除します。いいえ。シェルは自分のデバイスとサーバーの間のSSHの中だけを通り、同期データは自分のiCloudのプライベートデータベースにあり、秘密鍵とパスワードはデバイスの外に出ません。利用データも送らず、アナリティクスもありません。Calida Labのサーバーを通るのは、通知をオンにしたときにリレーを経由する封をされた通知だけで、それを開ける鍵は自分のデバイスにしかありません。
どちらもありません。keeperは自分のアカウントとしてホームディレクトリから動き、0700のディレクトリにあるUnixソケットだけを使います。入口は自分のSSHログインだけで、システム全体にインストールするものはありません。
ほかの一般ユーザーは入れません。自分のアカウントとrootは入れます。tmuxやscreenと同じです。管理者を信頼できないサーバーでは、シェルに秘密情報を置かないでください。
SSHのエージェントフォワーディングは、プロトコルの性質上、そのサーバーのrootもフォワードされたエージェントを使えます。SpectaShellはデバイス鍵を使うたびにFace IDやTouch IDで個別に確認するので、知らないうちに使われることはありません。サーバーが鍵を追加・削除することもできません。ただし、MacのSSHエージェントの鍵は、sshと同じく確認なしで渡ります。信頼できるサーバーでだけオンにしてください。
同期しているホスト一覧とスニペットは見られてしまいます。ただし、鍵とパスワードは同期しないので、サーバーにはログインできません。新しいデバイスの一覧用の鍵も、既存のデバイスが承認するまではサーバーに置かれません。スニペットにはパスワードやトークンを入れないでください。
グループの共有はApple Account同士のCloudKit共有で、やり取りされるのはサーバーの名前とアドレスだけです。開けるのは招待した人だけです(リンクを知っている誰でも参加できるよう、自分で設定した場合を除きます)。鍵やパスワードは共有されず、共有しただけでは誰もログインできません。誰がログインできるかは、サーバーのauthorized_keysが決めます。メンバーはそれぞれ自分のデバイス鍵を使い、そのサーバーにログインできる人に「Who May Log In…」で入れてもらいます。メンバーを自分のアカウントに入れると、そのアカウントのシェルをすべて見て操作できるので、人ごとに別のアカウントを用意してください。
Macで開くローカルシェルは自分のファイルにアクセスする必要がありますが、サンドボックス化されたアプリのシェルにはそれができないからです。そのため、iTerm2やGhosttyと同じように、Developer IDで署名し、Appleの公証を受けて直接配布しています。iPadとiPhoneのアプリはApp Storeのアプリなので、サンドボックスの中で動きます。ローカルシェルは持たず、サーバーのシェルだけを開きます。
別のデバイスで「Keys」を開き、なくしたデバイスの横にある「Remove from Every Host…」を選んでください。すべてのサーバーからそのデバイスの鍵を削除し、そのデバイスへの通知も止めます。あわせて、「探す」でデバイスを消去し、Apple Accountからも削除してください。
そのサーバーのシェルをすべて閉じてから、08 · サーバーに残るものにあるディレクトリを削除し、~/.ssh/authorized_keysから、コメントがSpectaShell(初期のビルドではsdTerm)で始まる行を削除してください。