見出し画像

【2021年10月版】SourceTree GitHubへのSSH接続方法

GitHubでは2021年8月13日にパスワード認証が廃止されました。
https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/

したがって、今後はSSH接続が必須となるようです。

コマンドベースでの接続方法はちまたに出回っていますが、
SourceTreeを用いたGUIを使っての手順はあまり情報がないので、ここに残そうと思います。

またこの記事はGitリポジトリをクローンする手順を解説していますが、既にHTTPS接続している場合も似たようなアプローチになるはずです。

SourceTree(PuTTY)を使用してSSHキーを作成

まずSourceTreeを使って、『SSHキー』を作成する必要があります。
SourceTreeを起動して、「SSHキーの作成/インポート」を選択。

画像1

表示された『PuTTY Key Generator』ウインドウの「Generate」を選択。

画像2

どうやらマウスの動きを使って生成するようです。赤い範囲をぐりぐりなぞってゲージを溜めましょう。

画像3

キーの生成に成功すると、画面が切り替わります。
この画面は色々使うので、手順の最後まで「×」を押して閉じないようにしてください

画像4

GitHubにSSHキー(パブリック)を登録

先程作成したSSHキー(パブリック)をGitHubに登録しましょう。
GiTHubログインして「Settings」を選択。

画像5

「SSH and GPG keys」を選択。

画像6

「New SSH key」を選択。

画像7

「Title」は任意の文字でよいです。 SourceTreeのSSHキーだと分かる名前がベターかもしれません。
「Key」に『PuTTY Key Generator』ウインドウの『Public Key for pasting~』のテキストエリア内の文字列をコピー&ペーストしましょう。

画像8

『SSH Keys』に先程追加したSSHキーが表示されていれば成功です。

画像9

登録した SSHキー でリポジトリのクローン

最後に、SourceTreeよりリポジトリのクローンです。
その前に、『PuTTY Key Generator』ウインドウで作成したSSHキーをローカルに保存する必要があります。
「Save public key」を押して保存したファイルは「id_rsa.pub」と名付けましょう。
「Save private key」を押して保存したファイルは「id_rsa.ppk」と名付けましょう。(ダイアログが出ても気にせず続行)

画像10

名前はなんでもよいです。が、大体そういった名前で付けることが多いようです。
配置場所はどこでもよいですが、私は『C\Users\{account}』直下に置くことが多いです。
※また、実は本手順で必要なのは「id_rsa.ppk」のみですが、「id_rsa.pub」もあった方が今後何かと都合がよいです。気にせず保存しておきましょう。

SourceTreeに先程保存したSSHキー(プライベート)を設定しましょう。
「オプション」を選択。

画像11

『SSH クライアントの設定』欄の「SSHキー」に、保存した「id_rsa.ppk(プライベートキー)」を設定します。
また、SSHクライアントが「PuTTY/Plink」となっていない場合は修正しておきましょう。

画像12

ここまでで設定は完了です。実際にクローンしていきます。
『Clone』より、リポジトリのクローンをします。「元のパス/URL」はもちろん対象リポジトリのSSHURLを指定しましょう。
恐らく、URLを指定した際にログインダイアログが出てくるはずです。そちらはGitHubのアカウント情報を入力しましょう。
認証に成功すれば、『これはGitリポジトリです』というメッセージが表示され、クローンできます。

画像13

補足

2021年10月06日現在、Windows向けのSourceTree最新バージョン(3.4.5)でSSHを用いたクローンが出来ないバグが発生しているようです。
このバグが発生している状態では逆立ちしてもクローンできないので、大人しく過去バージョン(3.4.4)をインストールしましょう。
https://community.atlassian.com/t5/Sourcetree-questions/SourceTree3-4-5%E3%81%A7%E3%83%AA%E3%83%A2%E3%83%BC%E3%83%88%E3%83%AA%E3%83%9D%E3%82%B8%E3%83%88%E3%83%AA%E3%81%8B%E3%82%89%E3%82%AF%E3%83%AD%E3%83%BC%E3%83%B3%E3%81%99%E3%82%8B%E3%81%A8SourceTree%E3%81%8C%E8%90%BD%E3%81%A1%E3%82%8B/qaq-p/1734173

この記事が気に入ったらサポートをしてみませんか?