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上の鍵を削除してから再登録してみてください。 |