MacでGitを使っていて、
git pushやgit pullが失敗する- 認証エラーが出て先に進めない
- 昨日まで動いていたのに急にエラーになる
といった状況に困ったことはありませんか。
Gitの認証エラーは、
設定や認証方式の変更が原因で起こることがほとんどです。
この記事では、
MacでGitの認証エラーが出たときに確認すべき基本的な対処法を、
初心者向けに順番に解説します。
※ 本記事は Mac環境/Gitの基本操作を前提 に説明します。
目次
この記事でわかること
- Gitの認証エラーが起こる理由
- HTTPSとSSHの違い
- 認証方式ごとの確認ポイント
- 初心者がつまずきやすい注意点
よくある認証エラー例
Gitの認証エラーでは、
次のようなメッセージが表示されることがあります。
Authentication failedPermission denied (publickey)fatal: Authentication failedremote: Permission to ~ denied
エラーメッセージによって、
原因の方向性を判断できます。
まず確認する:認証方式を把握する
最初に、
どの認証方式を使っているかを確認します。
git remote -v
表示されるURLが、
https://...→ HTTPS接続git@github.com:...→ SSH接続
どちらかを確認してください。
HTTPS接続で認証エラーが出る場合
原因① パスワード認証を使おうとしている
現在、GitHubなどでは
パスワード認証は使えません。
HTTPS接続では、
アクセストークン(Personal Access Token) が必要です。
対処法① トークンを使って認証する
- GitHubでトークンを発行
- ユーザー名:GitHubのユーザー名
- パスワード:発行したトークン
を入力します。
対処法② 認証情報が古い場合
以前の認証情報が残っていると、
エラーになることがあります。
この場合は、
- キーチェーンアクセス
- Gitの認証情報
を削除して、再入力します。
SSH接続で認証エラーが出る場合
原因② SSHキーが登録されていない
SSH接続の場合、
SSHキーがGitHubなどに登録されていないと
認証エラーになります。
接続テスト:
ssh -T git@github.com
エラーが出る場合は、
SSHキー設定に問題があります。
原因③ SSHキーはあるが読み込まれていない
SSHキーを作成していても、
Mac側で読み込まれていないケースがあります。
この場合は、
- SSHエージェント
- SSH設定ファイル
の確認が必要です。
よくある勘違い
Gitの認証エラーで、
次のような誤解が多いです。
- GitHubが落ちていると思ってしまう
- Gitが壊れたと考えてしまう
- 毎回同じコマンドを繰り返す
多くの場合、
認証方式を一つ確認するだけで解決します。
まず確認すべきチェックリスト
認証エラーが出たら、
次の順番で確認してください。
git remote -vで認証方式を確認- HTTPSかSSHかを把握
- HTTPSならトークンを使っているか
- SSHならSSHキーが登録されているか
- 書き込み権限があるか
この順で確認すれば、
原因はほぼ特定できます。
まとめ
MacでGitの認証エラーが出る場合、
原因の多くは次のいずれかです。
- HTTPSでパスワードを使おうとしている
- トークンが無効・期限切れ
- SSHキーが未登録・未読込
- リポジトリの権限がない
落ち着いて認証方式を確認することが、
解決への近道です。
コメントを残す