GitHubへの接続設定

GitHubアカウントを作成しただけでは、ローカルのターミナルからGitHubにコードをプッシュすることはできません。ローカルからGitHubに安全にアクセスするために、SSH鍵を使った認証を設定します。

📝 SSH鍵とは
SSH鍵は、公開鍵と秘密鍵のペアで構成される認証方式です。秘密鍵はローカルPCに保存し、公開鍵をGitHubに登録します。通信時に鍵のペアが一致するかを検証することで、パスワードを入力せずに安全にGitHubにアクセスできるようになります。

1. SSH鍵の作成

ターミナル(Windowsの場合はコマンドプロンプトまたはPowerShell)で、以下のコマンドを実行してSSH鍵を作成します。メールアドレスはGitHubに登録したものに置き換えてください。

ssh-keygen -t ed25519 -C "your-email@example.com"

実行するといくつか質問が表示されますが、すべてそのままEnterキーを押してください。

Generating public/private ed25519 key pair.
Enter file in which to save the key (/Users/you/.ssh/id_ed25519):  ← そのままEnter
Enter passphrase (empty for no passphrase):  ← そのままEnter
Enter same passphrase again:  ← そのままEnter

これにより、以下の2つのファイルが作成されます。

ファイル 説明
~/.ssh/id_ed25519 秘密鍵(ローカルPCに保管。他人に共有しない)
~/.ssh/id_ed25519.pub 公開鍵(GitHubに登録する)
💡 ポイント
秘密鍵(id_ed25519)は絶対に他人に共有しないでください。GitHubに登録するのは公開鍵(id_ed25519.pub)のほうです。

2. 公開鍵のコピー

作成した公開鍵の内容をコピーします。

2.1 Macの場合

pbcopy < ~/.ssh/id_ed25519.pub

上記のコマンドを実行すると、公開鍵の内容がクリップボードにコピーされます。

2.2 Windowsの場合

clip < ~/.ssh/id_ed25519.pub

上記のコマンドを実行すると、公開鍵の内容がクリップボードにコピーされます。

⚠️ コマンドでコピーできない場合
上記のコマンドが使えない場合は、cat ~/.ssh/id_ed25519.pubを実行して表示された内容を手動でコピーしてください。ssh-ed25519から始まる1行をすべて選択してコピーします。

3. GitHubに公開鍵を登録

コピーした公開鍵をGitHubに登録します。

GitHubにログインし、右上のアイコンをクリックしてSettingsを選択します。

左側のメニューからSSH and GPG keysを選択し、New SSH keyをクリックします。

下記の内容を入力してください。

設定項目 入力内容 設定の基準
Title 任意の名前(例: My Laptop) どのPCの鍵かを識別するため
Key type Authentication Key 認証用の鍵として使用するため
Key 先ほどコピーした公開鍵 ローカルPCとの認証に使用するため

入力が終わったらAdd SSH keyをクリックします。GitHubのパスワードを求められた場合は入力してください。

4. 接続の確認

SSH鍵の登録が完了したら、ローカルからGitHubに正しく接続できるか確認します。以下のコマンドを実行してください。

ssh -T git@github.com

初回接続時には以下のような確認メッセージが表示されます。yesと入力してEnterキーを押してください。

The authenticity of host 'github.com (xx.xx.xx.xx)' can't be established.
ED25519 key fingerprint is SHA256:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.
Are you sure you want to continue connecting (yes/no/[fingerprint])? yes

接続に成功すると、以下のようなメッセージが表示されます。

Hi username! You've successfully authenticated, but GitHub does not provide shell access.

Hi username!の部分にご自身のGitHubユーザ名が表示されていれば、SSHによるGitHubへの接続設定は完了です。

⚠️ 「Permission denied (publickey)」と表示される場合
(1) SSH鍵が正しく作成されているか確認してください(ls ~/.ssh/id_ed25519.pubでファイルが存在するか確認)。
(2) GitHubに登録した公開鍵の内容が正しいか確認してください。公開鍵を再度コピーし、GitHub上の鍵を削除してから再登録してみてください。