Git に GitHub の認証情報をキャッシュする

HTTPS を使用して GitHub Enterprise Server リポジトリをクローンする場合は、GitHub CLI または Git Credential Manager (GCM) を使用して資格情報を記憶することをお勧めします。

Platform navigation

この記事の内容

Tip

SSH を使って GitHub Enterprise Server リポジトリをクローンすると、他の資格情報ではなく SSH キーを使って認証することができます。 SSH 接続の設定については、「SSH を使用した GitHub への接続」をご覧ください。

GitHub CLI

GitHub CLI は、Git 操作の優先プロトコルとして HTTPS を選択すると自動的に Git 資格情報を格納し、GitHub Enterprise Server 資格情報で Git に対して認証するかどうかを尋ねるプロンプトに対して "はい" と答えます。

  1. macOS、Windows、または Linux に GitHub CLI をインストールします。
  2. コマンド ラインで、「gh auth login」と入力し、プロンプトに従います。
    • Git 操作の優先プロトコルの入力を求められたら、HTTPS を選択します。
    • GitHub Enterprise Server 資格情報を使用して Git に対する認証を行うかどうかを確認するメッセージが表示されたら、「Y」を入力します。

GitHub CLI を使用した認証の詳細については、「gh auth login」を参照してください。

Git Credential Manager

Git Credential Manager (GCM) は、資格情報を安全に保存し、HTTPS 経由で GitHub に接続するもう 1 つの方法です。 GCM を使うと、2FA (2 要素認証) を含む認証をユーザーの代わりに GCM が管理するため、手動で personal access token を作成して格納する必要はありません。

  1. Homebrew を使用して Git をインストールします。

    brew install git

  2. Homebrew を使用して GCM をインストールします。

    brew install --cask git-credential-manager

macOS の場合は、GCM によって Git が自動的に構成されるため、git config を実行する必要はありません。

認証が必要な HTTPS URL の複製を今度作成するとき、Git からブラウザー ウィンドウを利用してログインするように求められます。 最初に、OAuth app を承認するように求められる場合があります。 アカウントまたは組織で 2 要素認証が必要な場合は、2FA チャレンジを完了する必要もあります。

認証に成功すると、認証情報は macOS のキーチェーンに保存され、HTTPS URL をクローンするたびに使用されます。 Git では、資格情報を変更しない限り、コマンド ラインに資格情報を再入力する必要はありません。

  1. GCM を含む Git for Windows をインストールします。 詳細については、リリース ページの「Git for Windows のリリース」を参照してください。

常に最新バージョンをインストールすることをお勧めします。 少なくとも、バージョン 2.29 以降をインストールします。これは、GitHub の OAuth サポートを提供する最初のバージョンです。

認証が必要な HTTPS URL の複製を今度作成するとき、Git からブラウザー ウィンドウを利用してログインするように求められます。 最初に、OAuth app を承認するように求められる場合があります。 アカウントまたは組織で 2 要素認証が必要な場合は、2FA チャレンジを完了する必要もあります。

認証に成功すると、資格情報は Windows の資格情報マネージャーに保存され、HTTPS URL を複製するたびに使用されます。 Git では、資格情報を変更しない限り、コマンド ラインに資格情報を再入力する必要はありません。


Warning

以前のバージョンの Git for Windows には、Windows 用の Git Credential Manager が付属していました。 この古い製品はサポートが終了しており、OAuth を使用して GitHub に接続することはできません。 Git for Windows の最新バージョンにアップグレードすることをお勧めします。

Warning

Windows の資格情報マネージャーで正しくない、または期限切れの資格情報をキャッシュしている場合、Git は GitHub Enterprise Server にアクセスできません。 キャッシュされた資格情報をリセットして、Git から資格情報の入力を求めるダイアログが表示されるようにするには、資格情報マネージャーにアクセスします (Windows の [コントロール パネル] の [ユーザー アカウント] > [資格情報マネージャー])。 GitHub Enterprise Server エントリを探して削除します。

Linux の場合は、Git と GCM をインストールし、GCM を使用するように Git を構成します。

  1. ディストリビューションのパッケージ システムから Git をインストールします。 手順は、実行している Linux のフレーバーによって異なります。

  2. GCM をインストールします。 実行している Linux のフレーバーによって異なるため、GCM リポジトリの手順を参照してください。

  3. GCM を使用するように Git を構成します。 選択できるバッキング ストアがいくつかあるため、GCM のドキュメントを参照してセットアップを完了してください。 詳細については、GCM Linuxに関するページを参照してください。

認証が必要な HTTPS URL の複製を今度作成するとき、Git からブラウザー ウィンドウを利用してログインするように求められます。 最初に、OAuth app を承認するように求められる場合があります。 アカウントまたは組織で 2 要素認証が必要な場合は、2FA チャレンジを完了する必要もあります。

認証に成功すると、認証情報はお使いのシステムに保存され、HTTPS URL をクローンするたびに使用されます。 Git では、資格情報を変更しない限り、コマンド ラインに資格情報を再入力する必要はありません。

Linux に資格情報を格納するためのその他のオプションについては、Pro Git の「資格情報のストレージ」を参照してください。


GCM の詳細や問題の報告については、「Git Credential Manager」の公式 GCM ドキュメントを参照してください。