Secretive: macOS の SSH 接続に Touch ID 承認を付ける

           · · · ·

SSH_with_SecretAgent

これはなに?

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 による承認  |
|           秘密鍵             |           +-------------------+
+------------------------------+

特徴・制約

セットアップ手順

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) での確認

設定_一般_リモートログイン.jpg

「システム設定 → 一般 → 共有」で リモートログイン をオンにします。

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 その他    # → 通常の公開鍵認証

注意点・運用上のリスク

  1. ローカル (MacBook Air) が壊れると鍵を失う (Secure Enclave 由来、復旧不可)

    • 対策: バックアップ用に通常の Ed25519 鍵もサーバの authorized_keys に登録しておく
    • または別マシンに非 Secure Enclave 鍵を 1 つ用意
  2. ECDSA P-256 が古く感じるかもしれないが、現状の OpenSSH/sshd で標準サポート、安全性に問題なし

  3. サーバ (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 ← 今回採用

YubiKey + ssh-keygen -t ed25519-sk

1Password SSH Agent

ssh-add --apple-use-keychain (Apple 標準)

将来の検討余地


  1. 今回はこれを安全性のメリットとして採用 ↩︎

comments powered by Disqus