Secretive: macOS の SSH 接続に Touch ID 承認を付ける
macos · secretive · secure-enclave · ssh · touch-id

これはなに?
MacBook Air から自宅の Mac mini / Fedora へ SSH ログインするときに、Touch ID (もしくは Apple Watch) で承認する方法 をまとめた技術検討・実装メモです。OSS の ssh-agent「Secretive」で秘密鍵を Secure Enclave に保存し、署名のたびに Touch ID を要求する構成にしています。GitHub などそれ以外のホストは、従来どおりの公開鍵認証のまま使い分ける構成を採用しています。
Secretive について
maxgoedjen/secretive — SSH 鍵を Secure Enclave に格納する macOS アプリです。
アーキテクチャ
+------------------------------+
| ssh client |
+------------------------------+
| ^ (1) ssh クライアントが SSH_AUTH_SOCK/IdentityAgent のソケット経由で署名を要求
(1) | | (5) (2) SecretAgent が Secure Enclave に署名を依頼
v | (3) ユーザーが Touch ID (または Apple Watch) で承認
+------------------------------+ (4) Enclave 内で署名し、署名結果だけを返す
| SecretAgent | (5) SecretAgent が署名結果を ssh クライアントに返す
| (LaunchAgent, resident) |
+------------------------------+
| ^
(2) | | (4)
v |
+------------------------------+ +-------------------+
| Secure Enclave | <--(3)-- | User による承認 |
| 秘密鍵 | +-------------------+
+------------------------------+
特徴・制約
- 秘密鍵は Secure Enclave の外に出ない (エクスポート不可)
- 署名のたびに TouchID プロンプト (一定時間記憶も設定可)
- 使用時に macOS 通知 → 不正利用に気づける
- LaunchAgent (
com.maxgoedjen.Secretive.SecretAgent) として自動常駐 - ECDSA P-256 のみ (Secure Enclave の制限。Ed25519/RSA 不可)
- 鍵は当該 Mac でしか使えない (移植不可) 1
- macOS 限定
セットアップ手順
1. Secretive のインストールと鍵の作成 (ローカル)
brew install --cask secretive
ローカルで Secretive を起動し、Secure Enclave-backed の鍵を作成します (ECDSA 256bit)。 アプリ内で公開鍵が表示されるので、それをコピーしておきましょう。
2. 公開鍵を登録 (サーバ)
コピーした公開鍵を、各サーバの ~/.ssh/authorized_keys に追記します。この時点では、既存の鍵 (またはパスワード) でサーバにログインできる前提です。
# ローカルから実行。Secretive でコピーした公開鍵をクリップボードから流し込む
pbpaste | ssh fedora 'mkdir -p ~/.ssh && chmod 700 ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys'
pbpaste | ssh mac-mini 'mkdir -p ~/.ssh && chmod 700 ~/.ssh && cat >> ~/.ssh/authorized_keys && chmod 600 ~/.ssh/authorized_keys'
サーバ (fedora) での確認
# SELinux のコンテキストを修正 (手作業で ~/.ssh を作った場合に必要なことがある)
restorecon -Rv ~/.ssh
# sshd が ECDSA (ecdsa-sha2-nistp256) を受け付けるか確認
sudo sshd -T | grep -i pubkeyacceptedalgorithms
# システム全体の暗号ポリシーを確認 (DEFAULT なら ECDSA P-256 は許可されている)
update-crypto-policies --show
サーバ (mac-mini) での確認

「システム設定 → 一般 → 共有」で リモートログイン をオンにします。
3. ~/.ssh/config でホストを使い分け (ローカル)
# TouchID を使いたいサーバ
Host mac-mini fedora
IdentityAgent ~/Library/Containers/com.maxgoedjen.Secretive.SecretAgent/Data/socket.ssh
IdentitiesOnly yes
# それ以外は通常の鍵 + 既定の ssh-agent
Host *
IdentityFile ~/.ssh/id_ed25519
ポイント: IdentityAgent をホスト単位で上書きする。
Host mac-mini fedora のブロックだけ Secretive のソケットを使い、他のホストは通常の SSH_AUTH_SOCK (Apple の ssh-agent) が使われる。
ソケットパスは環境により
~/Library/Group Containers/...の場合もある。Secretive アプリの「Setup」画面で表示されるパスをコピーすること。
4. 動作確認 (ローカル)
ssh mac-mini # → TouchID プロンプト
ssh その他 # → 通常の公開鍵認証
注意点・運用上のリスク
-
ローカル (MacBook Air) が壊れると鍵を失う (Secure Enclave 由来、復旧不可)
- 対策: バックアップ用に通常の Ed25519 鍵もサーバの
authorized_keysに登録しておく - または別マシンに非 Secure Enclave 鍵を 1 つ用意
- 対策: バックアップ用に通常の Ed25519 鍵もサーバの
-
ECDSA P-256 が古く感じるかもしれないが、現状の OpenSSH/sshd で標準サポート、安全性に問題なし
-
サーバ (fedora) の sshd の
PubkeyAcceptedAlgorithmsで ECDSA を絞っていないか確認 (確認方法は手順 2 を参照)
補足: 逆方向 (Mac へ SSH ログインする時の TouchID)
別ケースとして「Macへ SSH ログインする際に TouchID 認証」をやりたい場合は pam_reattach + pam_tid.so 方式になる (今回の用途ではない)。
brew install pam-reattach
# /etc/pam.d/sshd
auth optional /opt/homebrew/lib/pam/pam_reattach.so ignore_ssh
auth sufficient pam_tid.so
# /etc/ssh/sshd_config
KbdInteractiveAuthentication yes
UsePAM yes
ただし公開鍵認証が優先されるので、鍵があるとそちらが使われ TouchID は呼ばれない。
他ソリューションとの比較
| 観点 | Secretive | YubiKey + ed25519-sk |
1Password SSH Agent | ssh-add --apple-use-keychain |
|---|---|---|---|---|
| 鍵の保管場所 | Secure Enclave | YubiKey (FIDO2) | 1Password 暗号化 vault | ファイル + Keychain (passphrase) |
| ハードウェア保護 | あり (T2/Apple Silicon) | あり (専用デバイス) | なし | なし |
| 使用ごとの認証 | TouchID | デバイスタッチ | TouchID/Watch | なし (一度解錠で permanent) |
| 鍵のエクスポート | 不可 | 不可 | 可 | 可 |
| 複数マシン共有 | 不可 (Mac 単位) | 物理キー持ち運び | vault 同期 | ファイルコピー |
| 対応アルゴリズム | ECDSA P-256 のみ | Ed25519, ECDSA | RSA, Ed25519, ECDSA | 全部 |
| 対応 OS | macOS のみ | クロスプラットフォーム | macOS/Win/Linux | macOS |
| コスト | 無料・OSS | $50〜70 | サブスク (~$3/月) | 無料 (組み込み) |
| メンテ | 活発 | 活発 | 活発 | Apple 公式 |
| 不正使用通知 | macOS 通知 | なし (タッチ要求のみ) | 1Password 通知 | なし |
どれを選ぶか
Secretive ← 今回採用
- Mac 1〜数台で完結する個人利用
- 物理キーを持ち歩きたくない
- 無料で済ませたい
YubiKey + ssh-keygen -t ed25519-sk
- 複数 OS (Win/Linux) を行き来する
- 鍵を物理的に持ち運びたい
- 紛失時にデバイスごと無効化できる安心感が欲しい
- Ed25519 を使いたい
- 仕事 / コンプライアンス要件あり
1Password SSH Agent
- すでに 1Password 利用中
- iPhone/iPad 含めて鍵を共有したい
- チーム鍵管理を統一したい
- vault でバックアップ・リカバリ
ssh-add --apple-use-keychain (Apple 標準)
- お手軽だが使用ごとの TouchID は出ない → 今回の要件には合わない
将来の検討余地
- Linux/Windows からも SSH するようになったら → YubiKey
- 複数 Mac で同じ鍵を使い回したくなったら → 1Password SSH Agent
- 段階的に乗り換える前提で、まずは Secretive で運用開始
-
今回はこれを安全性のメリットとして採用 ↩︎