ドキュメント · トピック
ホストと鍵
Moshpit は標準的な SSH サーバーに接続できます。パスワードと秘密鍵は端末の iOS キーチェーン内に保存され、運営側のアカウントやサーバーへアップロードされることは一切ありません。
接続を追加・編集する
Section titled “接続を追加・編集する”ホーム画面の 接続を追加 をタップするか、既存のホストカードを長押しして 接続を編集 を開きます:
- 名前 と 絵文字:分かりやすい表示名と、任意で 1 文字の絵文字を設定できます。
- ホスト、ポート、ユーザー名:ホスト名または IP アドレスのみ(例:
dev.example.comや192.0.2.10)、ポート(既定22)、SSH ユーザー名(例:dev)を入力します。 - 認証方法:パスワード、SSH キー、PEM を貼り付け から選びます。
- マルチプレクサ:tmux、herdr、使用しない から選びます。選んだマルチプレクサがホストに入っていない場合、別のものへ勝手に切り替えることはせず、通知したうえでプレーンシェルを開きます。
パスワード・SSH キー・Face ID
Section titled “パスワード・SSH キー・Face ID”再利用できる鍵は 設定 › SSH キー › キーを追加 で管理します:
| 方法 | 詳細 |
|---|---|
| 生成(ソフトウェア) | 端末上で ED25519(推奨)または RSA-4096 の鍵ペアを生成し、iOS キーチェーンに保存します。Face ID を要求 をオンにすると、署名のたびに生体認証が必要になります。 |
| 生成(Secure Enclave に保存) | Secure Enclave チップ内にハードウェア保護された ECDSA P-256 鍵を生成します。秘密鍵はチップの外に出ず、署名には Face ID を使います。 |
| 読み込む | ファイルを読み込む… をタップするか、OpenSSH / PEM 形式の秘密鍵を貼り付けます。パスフレーズ 付きの場合は読み込み時に一度入力し、復号後はキーチェーンで保護されます。 |
| PEM を貼り付け | 個別の接続フォームで 認証 › PEM を貼り付け から秘密鍵を直接貼り付けます。 |
設定 › SSH キー で鍵をタップすると 公開鍵をコピー または 公開鍵を共有 ができます。その 1 行をホストの ~/.ssh/authorized_keys に追記してください。
ホストキーの信頼とホストフェイス
Section titled “ホストキーの信頼とホストフェイス”サーバーへの初回接続時には、新しいホスト と SHA256 指紋 が表示されます。サーバー上で ssh-keygen -lf /etc/ssh/ssh_host_*_key.pub を実行して一致を確認してから 信頼 をタップしてください。
後からサーバーが異なる鍵を提示した場合、Moshpit は ホストキーが変更されました で接続を止め、保存済み と 今回提示された値 の両方の指紋を表示します。OS 再インストールなど変更理由が明確な場合以外は 切断 を選び、確認できた場合にのみ 新しいキーを信頼 をタップしてください。
各ホストカードには信頼済みホストキーから決定論的に生成された幾何学フェイス(ピクセルコンパニオン有効時はピクセル生物)が表示されます。接続に 絵文字 を設定すると、ひと目で見分けやすい絵文字表示に置き換わります。
新しい iPhone への復元
Section titled “新しい iPhone への復元”バックアップから新しい iPhone を設定すると、保存済み接続と信頼済みホストキーは引き継がれますが、キーチェーン項目は iOS の仕様で古い端末に残ります:
- 読み込んだ鍵:設定 › SSH キー の この iPhone にはありません セクションに表示されます。鍵をタップして もう一度読み込む… を選ぶと、ホストとの紐付けを保ったまま秘密鍵だけを復元できます。
- Secure Enclave キー:元の端末のチップ外へ取り出せません。古い項目を削除して新しい鍵を生成し、新しい公開鍵をサーバーへ追加してください。
- パスワードとインライン PEM キー:接続を編集 を開くと、パスワードや秘密鍵の再入力が求められます。