1. はじめに
githubを久しぶりに利用しようと思ったのですが、HTTPSでのpushでつまづいたため、その対応を記録するついでに、設定方法をメモしておきます。
(2024/12)
発行していたトークンが失効するため、Fine-grainedでの再発行・登録の手順を追加
[GitHub] Your personal access token (classic) is about to expire
Hi @*******,
We noticed your personal access token (classic) "*******" with read:org, repo, and workflow scopes will expire in about 18 hours.
If this token is still needed, visit https://github.com/settings/tokens/************/regenerate to generate an equivalent.
If you run into problems, please contact support by visiting https://github.com/contact
Thanks,
The GitHub Team
2. 概要
- githubのリポジトリへコードをpushする
- githubへの接続は「HTTPS」を利用し、「ssh」は使用しない
- HTTPS接続では、「トークン」を発行して接続する
- 「トークン」は端末に保存して使用する
3. 確認した環境
- Windows10
- Powershell
- git version 2.43.0.windows.1
4. GitHubのリポジトリ作成
リポジトリ作成
Privateで作成しました。
githubリポジトリの作成後画面
5. 表示されたコマンドの実行
リポジトリ作成時に案内されるコマンドは以下になります。
echo "# (リポジトリ名)" >> README.md
git init
git add README.md
git commit -m "first commit"
git branch -M main
git remote add origin https://github.com/(githubのID)/(リポジトリ名).git
git push -u origin main
表示されたコマンドをそのままの順で実行すると以下のエラーがでました。
(HTTPSで接続したはずなのに、なぜssh?)
> git push -u origin main
ssh: Could not resolve hostname github: Name or service not known
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.
git remoteの状況を確認します。pushの方がHTTPSの記載にはなっていませんでした。
> git remote -v
origin https://github.com/(githubのID)/(リポジトリ名).git (fetch)
origin github:(githubのID)/(リポジトリ名).git (push)
.gitconfigにて以下の記述を入れていたことが原因のようでした。なぜいれたのかは記憶がなく、接続方式を変換するための記述のようでしたので、この記述を消しました。
[url "github:"]
pushInsteadOf = https://github.com/
pushInsteadOf = git@github.com:
一度、remoteの設定を消して、再度設定します。両方、HTTPSのURLになりました。
> git remote rm origin
> git remote add origin https://github.com/(githubのID)/(リポジトリ名).git.git
> git remote -v
origin https://github.com/(githubのID)/(リポジトリ名).git (fetch)
origin https://github.com/(githubのID)/(リポジトリ名).git (push)
再度pushしようとすると以下のようにサインインが表示されました。
（ここでは一度中断しておきます。)
6. GitHubのアクセストークン発行・保管・削除方法
HTTPS接続にはアクセストークンの発行が必要なので、GitHubの画面から発行します。
トークンの発行
こちらの方法は「classic」となっているので、いずれ使えなくなる可能性があります。問題なければ後述の「Fine-grained」で作成した方がよいと思います。
「Settings」⇒「Developper Settings」から「Personal access tokens」を選択し、「Generate new token」から発行します。
NoteとExpiration(有効期限)を入れます。スコープ(Select Scopes)は最低限必要な「repo」と「workflow」、「admin:org」にある「read:org」にチェックを入れて作成します。（他にも必要であれば追加してください。)
トークンが発行されるので、コピーしておきます。（ここでしか表示されないので要注意)
左メニューのTokens(classic)を再度押すと、以下のように発行したものが表示されます。
トークンの発行(Fine-grained)
以下を見ると、Fine-grainedという新しい方法がpreviewになっており、こちらに移行していくものと思われます。
トークンの名前、設定したい対象のオーナー、有効期限を設定します。
設定したいリポジトリの対象を指定します。
Repository permissionsとAccount permissionsがありますが、最低限としてContentsをRead and Writeにしておきます。
Metadataは必須項目のようです。
指定したものがOverviewに表示されます。
「Generate Token」を押すと以下のようにトークンが発行されます。
この画面でしか表示されないので、コピーしておきます。
認証情報の保管場所と削除方法
認証情報を端末に保管する方法はいくつかあるようですが、Git Credential Managerで保存することにしました。
https://docs.github.com/ja/get-started/getting-started-with-git/caching-your-github-credentials-in-git
gitをいれた時に入っていたようです。
> git credential-manager --version
2.4.1
> git config --show-origin credential.helper
file:C:/Program Files/Git/etc/gitconfig manager
利用方法
初回にGitHubの操作を行った際、サインインが出るので、Tokenを選択して発行したトークン文字列をいれます。
以降、こちらの認証情報が使用されるようです。
認証情報が保存されている場所
認証情報はWindowsの資格情報マネージャー(Windows Credential Manager)に保管されているようです。
Windows資格情報の方にあります。
汎用資格情報の中にgithubの認証がありました。こちらの登録を削除すると再認証が必要になります。
認証情報の変更方法(トークンの更新)
Windows資格情報マネージャーで該当に項目を表示し、「編集」を押します。
コピーしておいたトークンをパスワードに貼り付けて登録します。