GitHubにローカル(Vagrant/CentOS7)からSSH接続を設定するのに、けっこう躓いてしまったので整理。GitHubに公開鍵をセットするのは当然として、ローカル側でいろいろ設定しないといけない。
流れは最後の「まとめ」に整理したが、概ね以下のような留意点あり。
ssh-addで秘密鍵を登録する必要があるssh-addに先立ってssh-agentを実行する必要がある
ssh -T コマンドでアクセスしようとしたところエラーになった。
|
1 2 3 4 5 6 7 |
[vagrant@localhost ~]$ ssh -T taustation@github.com The authenticity of host 'github.com (13.114.40.48)' can't be established. RSA key fingerprint is SHA256:nThbg6kXUpJWGl7E1IGOCspRomTxdCARLviKw6E5SY8. RSA key fingerprint is MD5:16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48. Are you sure you want to continue connecting (yes/no)? yes Warning: Permanently added 'github.com,13.114.40.48' (RSA) to the list of known hosts. Permission denied (publickey). |
参考サイトGitHubに接続できないときの対処法より、ssh-addするがエラー
|
1 2 3 4 |
[vagrant@localhost ~]$ ssh-add -l Could not open a connection to your authentication agent. [vagrant@localhost ~]$ ssh-add ~/.ssh/id_rsa Could not open a connection to your authentication agent. |
参考サイトssh-addできなかったときへの対処よりssh-agentを実行するがうまくいかない。
|
1 2 3 4 5 6 |
[vagrant@localhost ~]$ ssh-agent SSH_AUTH_SOCK=/tmp/ssh-rhbFsGUEFG3R/agent.25793; export SSH_AUTH_SOCK; SSH_AGENT_PID=25794; export SSH_AGENT_PID; echo Agent pid 25794; [vagrant@localhost ~]$ ssh-add ~/.ssh/id_rsa Could not open a connection to your authentication agent. |
直接実行しても内容が表示されているだけらしいので、同サイトにあるとおり、eval `ssh-agent'を実行してキーが追加された。
|
1 2 3 4 5 |
[vagrant@localhost ~]$ eval `ssh-agent` Agent pid 25798 [vagrant@localhost ~]$ ssh-add ~/.ssh/id_rsa Enter passphrase for /home/vagrant/.ssh/id_rsa: Identity added: /home/vagrant/.ssh/id_rsa (/home/vagrant/.ssh/id_rsa) |
ssh -Tを改めて実行し、(GitHubはシェルでのアクセスができないが)正しく認証されたことを確認。
|
1 2 3 |
[vagrant@localhost test]$ ssh -T git@github.com Warning: Permanently added the RSA host key for IP address '52.192.72.89' to the list of known hosts. Hi taustation! You've successfully authenticated, but GitHub does not provide shell access. |
ここでGitHub上に既に存在するリポジトリーをcloneしようとしたが、パーミッションで拒否される。
|
1 2 3 4 5 6 7 |
[vagrant@localhost git]$ git clone ssh://github.com/taustation/test.git test Cloning into 'test'... Permission denied (publickey). fatal: Could not read from remote repository. Please make sure you have the correct access rights and the repository exists. |
先の参考サイトGitHubに接続できないときの対処法の後ろの方を読むと、httpsでcloneしたリポジトリーはsshでは扱えないらしい。
そこでhttps認証に倣って以下のコマンドを打ってみるがうまくいかない。
|
1 2 3 4 5 6 7 |
[vagrant@localhost test]$ git clone ssh://github.com/taustation/test Cloning into 'test'... Permission denied (publickey). fatal: Could not read from remote repository. Please make sure you have the correct access rights and the repository exists. |
参考サイトベビーサンになりたいに倣ってURLを書いてみると、やっと接続できた。
|
1 2 3 4 5 6 7 |
[vagrant@localhost git]$ git clone git@github.com:taustation/test.git Cloning into 'test'... remote: Enumerating objects: 15, done. remote: Counting objects: 100% (15/15), done. remote: Compressing objects: 100% (8/8), done. remote: Total 15 (delta 0), reused 3 (delta 0), pack-reused 0 Receiving objects: 100% (15/15), done. |
これまでの流れで導入した鍵を別のマシンへ複製し、GitHubへ接続。
~/.ssh/下にあるid_rsaとid_rsa.pubの2つのキーファイルをもう1つのマシンの~/.ssh/下にコピー。この状態でssh -Tで認証が確認できた。
|
1 2 3 4 5 6 7 8 |
[vagrant@localhost .ssh]$ ssh -T git@github.com The authenticity of host 'github.com (52.192.72.89)' can't be established. RSA key fingerprint is SHA256:nThbg6kXUpJWGl7E1IGOCspRomTxdCARLviKw6E5SY8. RSA key fingerprint is MD5:16:27:ac:a5:76:28:2d:36:63:1b:56:4d:eb:df:a6:48. Are you sure you want to continue connecting (yes/no)? yes Warning: Permanently added 'github.com,52.192.72.89' (RSA) to the list of known hosts. Enter passphrase for key '/home/vagrant/.ssh/id_rsa': Hi taustation! You've successfully authenticated, but GitHub does not provide shell access. |
ただし、cloneやpull/pushなどのコマンドを実行するたびにパスフレーズの入力を求められる。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
[vagrant@localhost ~]$ git clone git@github.com:taustation/test.git Cloning into 'test'... Warning: Permanently added the RSA host key for IP address '13.114.40.48' to the list of known hosts. Enter passphrase for key '/home/vagrant/.ssh/id_rsa': remote: Enumerating objects: 40, done. remote: Counting objects: 100% (40/40), done. remote: Compressing objects: 100% (27/27), done. remote: Total 40 (delta 5), reused 25 (delta 1), pack-reused 0 Receiving objects: 100% (40/40), 5.91 KiB | 5.91 MiB/s, done. Resolving deltas: 100% (5/5), done. [vagrant@localhost test]$ git pull Enter passphrase for key '/home/vagrant/.ssh/id_rsa': Already up to date. |
そこで、ssh-agentとssh-addを実行する。
|
1 2 3 4 5 |
[vagrant@localhost test]$ eval `ssh-agent` Agent pid 19421 [vagrant@localhost test]$ ssh-add ~/.ssh/id_rsa Enter passphrase for /home/vagrant/.ssh/id_rsa: Identity added: /home/vagrant/.ssh/id_rsa (/home/vagrant/.ssh/id_rsa) |
これで毎回パスフレーズを入力する必要がなくなった。
|
1 2 |
[vagrant@localhost test]$ git pull Already up to date. |
ひとまず、以下の流れでSSH接続を整理。
eval `ssh-agent`を実行ssh-add ~/.ssh/id_rsaで秘密鍵登録ssh -T git@github.comで認証成功を確認git clone git@github.com:ユーザー名/リポジトリー名.gitpull/push鍵のペアーを他のマシンに複製して同じアカウントにアクセスする場合、
id_rsa、id_rsa.pubを他のマシンの~/.ssh/ディレクトリーにコピーeval `ssh-agent`を実行ssh-add ~/.ssh/id_rsaで秘密鍵登録
GitからGitHubにプッシュ・プルする手順。最初にリポジトリーを作成する場合、GitHub上にあらかじめリモートリポジトリーを作成しておいて、これをローカルにgit cloneで取り込む。
パスワード認証が2段階になり、Personal Access Token (PAT)を用いるようになったため、リモートでGitHubに接続する際のパスワード認証ではPATを入力することとなっている。
Gitのデフォルトブランチ名はmasterだが、GitHubがデフォルトブランチ名をmainとしたことから、Gitでもmasterからmainに変更するよう設定。
|
1 2 3 4 5 6 7 8 9 |
[vagrant@localhost ~]$ git config --global init.defaultBranch main [vagrant@localhost ~]$ cat .gitconfig [user] name = taustation email = taustation@gmail.com [color] ui = auto [init] defaultBranch = main |
GitHub上に新しいリポジトリーを作成。
test"My very first repository"ローカルのワーキングディレクトリーにGitHubのリポジトリーをクローン。
|
1 2 3 4 5 6 7 8 9 |
[vagrant@localhost git]$ git clone https://github.com/taustation/test test Cloning into 'test'... Username for 'https://github.com': taustation Password for 'https://taustation@github.com': remote: Enumerating objects: 6, done. remote: Counting objects: 100% (6/6), done. remote: Compressing objects: 100% (2/2), done. remote: Total 6 (delta 0), reused 0 (delta 0), pack-reused 0 Unpacking objects: 100% (6/6), done. |
GitHubで作成したREADMI.mdファイルの内容が確認できる。
|
1 2 3 4 5 |
[vagrant@localhost git]$ cd test [vagrant@localhost test]$ ls README.md [vagrant@localhost test]$ cat README.md My very first repository |
ワーキングディレクトリーに新たにsample.txtファイルを追加する。
|
1 2 3 4 5 6 7 8 |
[vagrant@localhost test]$ vi sample.txt [vagrant@localhost test]$ ls -Al 合計 8... drwxrwxr-x. 8 vagrant vagrant 163 8月 5 16:23 .git -rw-rw-r--. 1 vagrant vagrant 25 8月 5 16:23 README.md -rw-rw-r--. 1 vagrant vagrant 25 8月 5 16:38 sample.txt [vagrant@localhost test]$ cat sample.txt 新規ファイル追加 |
そして追加したファイルをステージング、コミット。
Laravelなどのフレームワークの場合、.gitignoreで指定されたファイルも併せて環境ごとpushするには、ステージングで以下のオプションを指定する。
git add -f .
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
[vagrant@localhost test]$ git add . [vagrant@localhost test]$ git status On branch main Your branch is up to date with 'origin/main'. Changes to be committed: (use "git restore --staged <file>..." to unstage) new file: sample.txt [vagrant@localhost test]$ git commit -m "Added sample.txt" [main b3f7d95] Added sample.txt 1 file changed, 1 insertion(+) create mode 100644 sample.txt |
git pushでコミットされた内容をプッシュ。
git push -u [URL] [branch]
[URL]はGitHubのリポジトリーのURLで、[branch]はリモートリポジトリーのブランチ。GitHubからcloneで複製したディレクトリー内の場合、git pushのみで実行可能。
コマンドを入力するとユーザー名とパスワードを聞かれるので、GitHubのユーザー名とパスワードを入力する。
|
1 2 3 4 5 6 7 8 9 10 |
[vagrant@localhost test]$ git push Username for 'https://github.com': taustation Password for 'https://taustation@github.com': Enumerating objects: 4, done. Counting objects: 100% (4/4), done. Compressing objects: 100% (2/2), done. Writing objects: 100% (3/3), 312 bytes | 312.00 KiB/s, done. Total 3 (delta 0), reused 0 (delta 0) To https://github.com/taustation/test 246a434..b3f7d95 main -> main |
これでローカルでの変更結果がGitHubのリポジトリーに反映され、GitHub上で変更結果を確認できる。
他で変更された可能性のあるリポジトリーで作業を開始する場合、リモートリポジトリーからプルする。
以下はGitHub側でREADME.mdの内容を編集した後に、ローカルでプルしている例。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 |
[vagrant@localhost test]$ git pull Username for 'https://github.com': taustation Password for 'https://taustation@github.com': remote: Enumerating objects: 8, done. remote: Counting objects: 100% (8/8), done. remote: Compressing objects: 100% (4/4), done. remote: Total 6 (delta 0), reused 0 (delta 0), pack-reused 0 Unpacking objects: 100% (6/6), done. From https://github.com/taustation/test b3f7d95..d257198 main -> origin/main Updating b3f7d95..d257198 Fast-forward README.md | 2 ++ 1 file changed, 2 insertions(+) |
Gitでコミットした内容を、GitHubにpushするのにユーザー名とパスワードの入力したところ、問題なく内容は反映されたが以下のようなメールが届いた。
| Hi @taustation,
You recently used a password to access the repository at taustation/hello-world with git using git/1.8.3.1. Basic authentication using a password to Git is deprecated and will soon no longer work. Visit https://github.blog/2020-12-15-token-authentication-requirements-for-git-operations/ for more information around suggested workarounds and removal dates. Thanks, |
リモートでのパスワード認証が2021年8月13日以降できなくなるらしい。
さらに、GitHubへのサインインの認証を2要素認証に変更したところ、パスワード認証ができなくなった。
|
1 2 3 4 5 |
[vagrant@localhost tutorial]$ git push https://github.com/taustation/tutorial master Username for 'https://github.com': taustation Password for 'https://taustation@github.com': remote: Invalid username or password. fatal: Authentication failed for 'https://github.com/taustation/tutorial/' |
改めてユーザ名とトークンを使ってGitの内容をpushする。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 |
[vagrant@localhost tutorial]$ git push https://github.com/taustation/tutorial master Username for 'https://github.com': taustation Password for 'https://taustation@github.com': Counting objects: 5, done. Compressing objects: 100% (2/2), done. Writing objects: 100% (5/5), 368 bytes | 0 bytes/s, done. Total 5 (delta 0), reused 0 (delta 0) remote: remote: Create a pull request for 'master' on GitHub by visiting: remote: https://github.com/********/tutorial/pull/new/master remote: To https://github.com/********/tutorial * [new branch] master -> master |
トークンの内容をコンソールに貼り付けても表示のフィードバックがないが、Enterキーを押して無事処理された。
SSH認証を設定すると、ユーザー名・パスワードの入力が必要なくなる。
ダッシュボードに表示されるHello worldガイドは、GitHub上でのリポジトリーの一連の操作を学習。
ダッシュボードページからHello worldガイドのページへ遷移する。
新しいリポジトリーを”hello-world”という名前で作成する。リポジトリーにはREADME.mdファイルのみが作成される。
mainに対してreadme-editsという名前でブランチを作成する。
新しく作成したreadme-editsブランチのREADME.mdファイルの内容を変更し、変更内容をコミット。
ファイルを変更したreadme-editsブランチをプルリクエスト。
readme-editsブランチのプルリクエストをmainにマージ。
mainのREADME.mdファイルの内容が変更されているのが確認できる。
サインアップの流れは以下のとおり。
Create your accountページ
Welcome to GitHubページ
GitHubサインイン時、ユーザー名とパスワードに加えて6桁のコードの入力が求められる。
登録したアドレスに送られるメールでコードを得られるが、平文で危険あり、毎回メールが送信されるのも面倒。
GitHubでは2要素認証(two-factor authentication: 2FA)を推奨しており、スマートフォンのアプリと紐づけることでアプリからコードを得られる。
SMSも選択できるが、日本のキャリアには対応していないらしい。
2要素認証の設定はこちらに整理。
GitHub登録後にサインインしようとすると、”Device verification”を求めらるページに遷移した。6桁の端末認証コードの入力が必要で、登録したEmailに認証コードを送ったとのこと(20210803時点)。
| Hey taustation!
A sign in attempt requires further verification because we did not recognize your device. To complete the sign in, enter the verification code on the unrecognized device. Device: Chrome on Windows |
この6桁のコード(Verification code)をブラウザーで入力すると、すぐにサインインした。
このメールでは以下のメッセージが続いている。
| If you did not attempt to sign in to your account, your password may be compromised. Visit https://github.com/settings/security to create a new, strong password for your GitHub account.
If you’d like to automatically verify devices in the future, consider enabling two-factor authentication on your account. Visit https://docs.github.com/articles/configuring-two-factor-authentication to learn about two-factor authentication. If you decide to enable two-factor authentication, ensure you retain access to one or more account recovery methods. See https://docs.github.com/articles/configuring-two-factor-authentication-recovery-methods in the GitHub Help. |
1段落目は、もしサインインしようとしていないのにこのメールが届いた場合、パスワードが盗まれている可能性があることを示唆している。リンクをクリックすると、サインイン中ならパスワード変更のページに遷移する。
2段落目は、デバイスの認証を自動化したい場合には2段階認証とするよう示唆している。
3段落目は、2段階認証にする場合のリカバリー手順を保存しておくことを示唆している。
スマートフォンのGoogle Playで”認証システム”で検索してヒットするGoogle認証システムをインストール。URLは以下のとおり。
https://play.google.com/store/apps/details?id=com.google.android.apps.authenticator2&hl=ja
インストール後のアプリケーション名が日本語の「認証システム」なのでちょっと見つけにくかった。
認証アプリへのGitHubの登録