キー

キーページ（iPad ではサイドバー、iPhone では「キー」タブ）で SSH キーを管理します。秘密鍵の実体があるのは iOS のキーチェーンの中だけで、Tessera が自身のデータベースに保存するのは公開されたメタデータ（名前、フィンガープリント、使用状況）だけです。

キーの生成

+ 生成をタップして、アルゴリズムを選びます。

Ed25519 — 「高速で現代的な既定値」。キーチェーンに保存されるソフトウェアキーで、復旧ファイルに書き出して別のデバイスへ移せます。
P-256 Secure Enclave キー — 「デバイスに紐づく」。Secure Enclave の中で生成され、そこから出ることはありません。このキーは書き出しも、他のデバイスへの移動もできません。デバイスを失えばキーも失われます — 別の認可済みキーをどこかに用意しておいてください。

RSA の生成には対応していません。トラブルシューティングを参照してください。

キーの読み込み

読み込むをタップして、OpenSSH の秘密鍵ファイル（1 MB まで）を選びます。ファイルがパスフレーズで保護されている場合、そのパスフレーズは復号のために一度だけ使われ、保持されません。

読み込めるのは Ed25519 だけです。現在の SSH スタックは非推奨の RSA/SHA-1 署名しか提示できないため、RSA の読み込みは無効です。代わりに Ed25519 を使用してください。
画面がキャプチャされたときやアプリがバックグラウンドに移ったとき、読み込み用のシートは自動的に隠れます（「秘密鍵の読み込みを非表示」）。

生体認証による保護

どのキーにも生体認証またはパスコードを要求のトグルがあります。オンにすると、 Tessera がそのキーにアクセスするたびに Face ID / Touch ID かデバイスのパスコードが必要になります。ソフトウェアの Ed25519 キーでは、キーチェーンの境界で iOS がこれを強制します。P-256 Secure Enclave キーでは、鍵の実体が Secure Enclave の外に出ることはなく、使うたびに Tessera 自身が認証を強制します — この設定を後から変更できるのはそのためです。変更できない必須のタグが付くのは、この設定ができるようになる前に作成されたキーだけです。

連続接続の認可

設定 → セキュリティ → キーによる連続接続をまとめて認可では、1 回の生体認証で、同じキーを使った同じエンドポイントへの繰り返しの接続を 30 秒間カバーできます。 tmux のタブやファイル転送のたびに認証を求められることがなくなります。アプリをバックグラウンドに移すと、アプリロックがオフのときでも、この許可は必ず無効になります。

このトグルはキーの生成時や読み込み時に選べ、あとからキーの詳細で変更できます。例外は、この設定ができるようになる前に作成された P-256 Secure Enclave キーです。これらは変更できない必須のタグを持っており、変更するには新しいキーを生成して差し替えるしかありません。

キーの詳細パネル

キーをタップすると、種類、フィンガープリント (sha256)（OpenSSH 互換）、公開鍵が表示されます。ここから次の操作ができます。

公開鍵をコピー — authorized_keysの 1 行です。
ホストにコピー… — サーバーに設置します（後述）。
秘密鍵を書き出す… — Ed25519 のみ。パスフレーズで暗号化した openssh-key-v1の復旧ファイルを書き出します。
ローカルの秘密鍵を削除… — 削除を参照してください。

使用元のセクションには、そのキーを参照しているホストが一覧表示されます。

ホストへのキーの設置

**ホストにコピー…**でホストを選ぶと、authorized_keysに追加される行がそのまま表示され、SSH 経由で~/.ssh/authorized_keysに検証用のマーカー付きで追記されます。

先にホストキーを信頼しておく必要があります。まず一度接続して内容を確認してから、やり直してください。
すでにそのキーを認証に使っているホストには、Tessera はキーを設置しません。
完了した設置は記録され、削除の手順で報告されます（「把握しているリモート設置数: N」）。

書き出しと復旧

キーの復旧セクションは、そのキーのバックアップ状態を記録します。検証済みの復旧ファイルの書き出しがあるかどうか（日付とフィンガープリント付き）が分かり、 Enclave キーの場合は、Secure Enclave 内の秘密情報はデバイスの外に出せないという注意が常に表示されます。

復旧キーを保護… — パスフレーズを付けて書き出します。
復旧ファイルを検証… — 復旧ファイルが今もそのキーと一致するか確認します。
復旧ファイルから復元… — キーチェーンの情報が失われていたり一致しなかったりする場合に、フィンガープリントを照合して修復します（バックアップから復元したあとなど）。

ソフトウェアキーを広く設置する前に、バックアップを取ってください。復旧できないキーは、パスワード認証を無効にしていくにつれて、自分自身を締め出すことを意味します。

キーの削除

**ローカルの秘密鍵を削除…**は、確認のうえでキーをキーチェーンから削除します。ローカルで削除しても、サーバー上のauthorized_keysのエントリが 失効することはありません。記録済みのホストに使える代替の資格情報がある場合、削除の手順で「記録済みの N 台のホストで失効させて削除」が提示され、まとめて削除できます。そうでない場合は、キーを使えなくしたいなら、各サーバーで該当する行を自分で削除してください。

以前のバージョンから残っているレガシー RSA キーは、無効の状態で表示されます。

孤立したキーチェーン項目

iOS はアプリを削除して再インストールしてもキーチェーンの項目を保持するため、キーのメタデータとキーの実体がずれることがあります。秘密情報が失われたキーは、一覧に 秘密情報がありませんのバッジ付きで表示されます（復旧ファイルから復元で直せます）。対応するキーのない秘密情報が残っている場合は「孤立したキーチェーン項目 N 件」として現れ、**クリーンアップを確認…**の手順が用意されます。迷う場合は、先に復旧ファイルを書き出してから削除してください。

デバイスアクセス

このデバイスを承認によって、あなたの別のデバイスがホストに登録されると、その許可がここに記録されます。相手のデバイス、方向、ホスト、キーのフィンガープリントが残ります。失効は、設置したときと同じくあなた自身のアクセス権を使って、そのデバイスの公開鍵をホストから削除します。ホストに到達できない場合、そのエントリは不確かな状態のまま残るので、再試行するか手動で片付けられます。

バイト列はどこにあるか

ソフトウェアの Ed25519 キー: iOS のキーチェーン（同期されません）。
P-256 キー: Secure Enclave。設計上、書き出しできません。
Tessera 自身のデータベース: 公開鍵、フィンガープリント、ラベル、使用状況。秘密情報は決して入りません。

堅牢化の全容については、公開されている秘密鍵のセキュリティ監査を参照してください。