macOS SSHキー自動設定（Git用）

事前準備：SSHキーペアの生成

1. ターミナルを開く
   Spotlight（⌘+Space）で「Terminal」を検索して開く

2. キーペアを生成する
   以下のコマンドを実行（[email protected]を自分のメールアドレスに置き換える）：

   ssh-keygen -t ed25519 -C "[email protected]" -f ~/.ssh/git_example

   • プロンプトが表示されたらEnterキーを押してデフォルト設定を使用
   • セキュリティを強化する場合は、パスフレーズを設定可能

3. 生成されたファイルを確認する
   ~/.sshディレクトリに2つのファイルが生成される：

   git_example    # 秘密鍵（厳重に保管）
   git_example.pub # 公開鍵（Gitサーバーに設定）

指定したキーを自動的に使用する設定

1. SSH設定ファイルを編集する

   mkdir -p ~/.ssh && chmod 700 ~/.ssh
   vim ~/.ssh/config

2. 設定内容を追加する
   以下のテンプレートを使用（必要に応じてパラメータを変更）：

   # メインのGitサービス設定
   Host git.example.com
       HostName git.example.com
       User git
       Port 22
       IdentityFile ~/.ssh/git_example
       IdentitiesOnly yes
   
   # 追加設定（その他のGitサービス用）
   Host github.com
       HostName github.com
       User git
       IdentityFile ~/.ssh/github_key

3. ファイルのパーミッションを設定する

   chmod 600 ~/.ssh/config

サーバー側の設定

1. 公開鍵をGitサービスに追加する
   公開鍵の内容をコピー：

   pbcopy < ~/.ssh/git_example.pub

   公開鍵を以下の場所に追加：
   • GitHub: Settings → SSH and GPG keys
   • GitLab: Preferences → SSH Keys
   • 自前のGitサービス：サーバーの~/.ssh/authorized_keysファイル

設定の確認

1. SSH接続をテストする

   ssh -T [email protected]

   成功すると、サービスプロバイダのウェルカムメッセージが表示される（例：GitHubの「Hi username!」）

2. リポジトリのクローンでテストする

   git clone [email protected]:username/repo.git

   システムは自動的に指定したキーを使用し、手動操作は不要

トラブルシューティング

1. デバッグモード
   -vオプションを追加して詳細な接続プロセスを表示：

   ssh -Tv [email protected]

2. よくある問題

   • エラーメッセージ「Permissions 0644 are too open」：chmod 600 ~/.ssh/*を実行
   • 接続タイムアウト：ファイアウォール設定またはネットワークプロキシ設定を確認
   • 認証失敗：サーバー側に公開鍵が正しく追加されているか確認

拡張応用

複数のHostブロックを設定することで、以下が可能：

• 異なるプラットフォームで異なるキーを使用（GitHub/GitLab/Gitee）
• 仕事用アカウントと個人用アカウントの分離
• 複数サーバー環境でのキー管理

注意：本記事の例ではgit.example.comはデモ用のドメインです。実際の使用時は自分のGitサービスアドレスに置き換えてください。