GitHub Desktop での GitHub への認証

GitHub を認証することで、GitHub Desktop 上のアカウントのリソースに安全にアクセスできます。

Platform navigation

この記事の内容

認証について

アカウントを安全に保つには、GitHub Desktop を使用して GitHub のリソースにアクセスする前に認証する必要があります。

認証する前には、GitHubでアカウントを既に持っている必要があります。 GitHub Enterprise Serverを使用する組織のメンバーで、アカウントをお持ちでない場合、GitHub Enterpriseサイト管理者にお問い合わせください。

GitHub 上のアカウントを認証する

  1. メニュー バーで [GitHub Desktop] を選び、 [環境設定] をクリックします。

    Mac のメニュー バーのスクリーンショット。 [GitHub Desktop] が開いており、青色で強調表示されている [環境設定] の上にカーソルが置かれています。

  2. [ユーザー設定] ウィンドウの [アカウント] ウィンドウで、「GitHub.com」の横にある [ログイン] ボタンをクリックします。

    [環境設定] ウィンドウの [アカウント] ペインのスクリーンショット。 [GitHub.com] の横に、"サインイン" というラベルが付いたボタンがオレンジ色の枠線で囲まれています。

  3. [ブラウザーを使ってサインイン] モーダル ウィンドウで、 [ブラウザーで続行] をクリックします。 GitHub Desktop はデフォルトのブラウザを開きます。

  4. GitHub に対して認証するには、GitHub.com での自分の資格情報を入力し、 [サインイン] をクリックします。

    あるいは、すでにGitHubにサインインしているなら、プロンプトに従ってGitHub Desktopに戻り、認証を完了させてください。

  5. GitHubで2要素認証（2FA）を設定したなら、以下のいずれかを行ってください。

    • SMS経由の2 要素認証をセットアップしたなら、SMSメッセージから2 要素認証コードを取得してください。
    • TOTPアプリケーションで2 要素認証をセットアップしたなら、2 要素認証コードを生成してください。

    続いて 2 要素認証コードを GitHub のプロンプトに入力し、 [Verify] (確認) をクリックしてください。

  6. アカウントが GitHub に認証されたら、プロンプトに従って GitHub Desktop に戻ります。

GitHub Enterprise Server 上のアカウントを認証する

  1. メニュー バーで [GitHub Desktop] を選び、 [環境設定] をクリックします。

    Mac のメニュー バーのスクリーンショット。 [GitHub Desktop] が開いており、青色で強調表示されている [環境設定] の上にカーソルが置かれています。

  2. [環境設定] ウィンドウの [アカウント] ペインで、[GitHub Enterprise] の横にある [サインイン] ボタンをクリックします。

    [環境設定] ウィンドウの [アカウント] ペインのスクリーンショット。 [GitHub Enterprise] の横に、"サインイン" というラベルが付いたボタンがオレンジ色の枠線で囲まれています。

  3. お使いの GitHub Enterprise Server インスタンス でアカウントを追加するには、[サインイン] モーダル ウィンドウの [Enterprise アドレス] にインスタンスの URL を入力して、 [続行] をクリックします。

  4. [ブラウザーを使ってサインイン] モーダル ウィンドウで、 [ブラウザーで続行] をクリックします。 GitHub Desktop はデフォルトのブラウザを開きます。

  5. お使いの GitHub Enterprise Server インスタンス アカウントに対して認証を行うには、アカウントの資格情報を入力して、 [サインイン] をクリックします。

    または、お使いの GitHub Enterprise Server インスタンス アカウントに既にサインインしている場合は、プロンプトに従って GitHub Desktop に戻り、認証を完了します。

GitHub 上のアカウントを認証する

  1. [ファイル] メニューを使用し、 [オプション] をクリックします。

    Windows の [GitHub Desktop] メニュー バーのスクリーンショット。 [ファイル] ドロップダウン メニューが展開されており、[オプション] 項目がオレンジ色の枠線で強調表示されています。

  2. [オプション] ウィンドウの [アカウント] ペインで、[GitHub.com] の横にある [サインイン] ボタンをクリックします。

    [オプション] ウィンドウの [アカウント] ペインのスクリーンショット。 [GitHub.com] の横に、"サインイン" というラベルが付いたボタンがオレンジ色の枠線で囲まれています。

  3. [ブラウザーを使ってサインイン] モーダル ウィンドウで、 [ブラウザーで続行] をクリックします。 GitHub Desktop はデフォルトのブラウザを開きます。

    警告: ユーザー名とパスワードで GitHub の認証を受けることは、サポートされていません。 代わりにブラウザーで認証を受けることをお勧めします。

  4. GitHub に対して認証するには、GitHub.com での自分の資格情報を入力し、 [サインイン] をクリックします。

    あるいは、すでにGitHubにサインインしているなら、プロンプトに従ってGitHub Desktopに戻り、認証を完了させてください。

  5. GitHubで2要素認証（2FA）を設定したなら、以下のいずれかを行ってください。

    • SMS経由の2 要素認証をセットアップしたなら、SMSメッセージから2 要素認証コードを取得してください。
    • TOTPアプリケーションで2 要素認証をセットアップしたなら、2 要素認証コードを生成してください。

    続いて 2 要素認証コードを GitHub のプロンプトに入力し、 [Verify] (確認) をクリックしてください。

  6. アカウントが GitHub に認証されたら、プロンプトに従って GitHub Desktop に戻ります。

GitHub Enterprise 上のアカウントを認証する

  1. [ファイル] メニューを使用し、 [オプション] をクリックします。

    Windows の [GitHub Desktop] メニュー バーのスクリーンショット。 [ファイル] ドロップダウン メニューが展開されており、[オプション] 項目がオレンジ色の枠線で強調表示されています。

  2. [オプション] ウィンドウの [アカウント] ペインで、[GitHub Enterprise] の横にある [サインイン] ボタンをクリックします。

    [オプション] ウィンドウの [アカウント] ペインのスクリーンショット。 [GitHub Enterprise] の横に、"サインイン" というラベルが付いたボタンがオレンジ色の枠線で囲まれています。

  3. GitHub Enterprise アカウントを追加するには、[Enterprise のアドレス] に資格情報を入力して [続行] をクリックします。

  4. GitHub Enterprise 用に 2 要素認証を設定したなら、以下のいずれかを行ってください。

    • SMS経由の2 要素認証をセットアップしたなら、SMSメッセージから2 要素認証コードを取得してください。
    • TOTPアプリケーションで2 要素認証をセットアップしたなら、2 要素認証コードを生成してください。

認証の問題のトラブルシューティング

GitHub Desktop で認証エラーが発生した場合は、エラーメッセージを使用してトラブルシューティングを行うことができます。

認証エラーが発生した場合は、まず GitHub Desktop 上のアカウントからサインアウトした後にサインインします。

一部のエラーでは、GitHub Desktop がエラーメッセージを表示します。 プロンプトが表示されない場合、またはエラーに関する詳細情報を確認する場合は、次のステップに従って GitHub Desktop ログファイルを表示します。

  1. メニュー バーで [ヘルプ] を選び、 [Finder でログを表示] をクリックします。

    Mac の [GitHub Desktop] メニュー バーのスクリーンショット。 展開された [ヘルプ] ドロップダウン メニューで、[Finder でログを表示] がポイントされ、青色で強調されています。

  2. 認証エラーが発生した日付からログファイルを選択します。

  1. [ヘルプ] ドロップダウン メニューを使用し、 [Show Logs in Explorer](Explorer でログを表示) をクリックします。

    Windows の [GitHub Desktop] メニュー バーのスクリーンショット。 展開された [ヘルプ] ドロップダウン メニューで、[エクスプローラーでログを表示] というラベルのオプションがオレンジ色で強調されています。

  2. 認証エラーが発生した日付からログファイルを選択します。

エラーメッセージについては、下記のトラブルシューティング情報を確認してください。

不正な認証情報

Error: Bad credentials

このエラーは、保存されているアカウントの認証情報に問題があることを示しています。

トラブルシューティングを行うには、GitHub Desktop でアカウントからサインアウトして、再度サインインします。

空のトークン

info: [ui] [AppStore.withAuthenticatingUser] account found for repository: node - USERNAME (empty token)

このエラーは、GitHub Desktop がシステムキーチェーンに作成したアクセストークンを見つけられないことを示しています。

トラブルシューティングを行うには、GitHub Desktop でアカウントからサインアウトして、再度サインインします。

リポジトリが見つからない

fatal: repository 'https://github.com/<user>/<repo>.git' not found

(The error was parsed as 8: The repository does not seem to exist anymore. You may not have access, or it may have been deleted or renamed.)

このエラーは、クローンを作成しようとしているリポジトリにアクセスする権限がないことを意味します。

トラブルシューティングを行うには、権限を管理する Organization 内の担当者にお問い合わせください。

リモートリポジトリから読み込めない

git@github.com: Permission denied (publickey).
fatal: Could not read from remote repository.

Please make sure you have the correct access rights and the repository exists.

このエラーは、有効な SSH キーが設定されていないことを示しています。

トラブルシューティングを行うには、「新しい SSH キーを生成して ssh-agent に追加する」をご覧ください。

クローン失敗

fatal: clone of 'git@github.com:<user>/<repo>' into submodule path '<path>' failed
Failed to clone 'src/github.com/<user>/<repo>'. Retry scheduled
Cloning into '<path>'...
git@github.com: Permission denied (publickey).
fatal: Could not read from remote repository.
Please make sure you have the correct access rights
and the repository exists.

このエラーは、クローンを作成しようとしているリポジトリにアクセス権のないサブモジュールがあるか、有効な SSH キーが設定されていないことを示しています。

サブモジュールにアクセスできない場合は、リポジトリの権限の管理者に連絡してトラブルシューティングを行ってください。

有効な SSH キーが設定されていない場合は、「新しい SSH キーを生成して ssh-agent に追加する」をご覧ください。

AskPass レスポンスが読み取れない

error: unable to read askpass response from '/Users/<path>/GitHub Desktop.app/Contents/Resources/app/static/ask-pass-trampoline.sh'
fatal: could not read Username for 'https://github.com': terminal prompts disabled

このエラーは、複数のイベントによって発生する可能性があります。

Command Processor レジストリ エントリが変更された場合、GitHub Desktop は Authentication failed エラーで応答します。 これらのレジストリエントリが変更されているかどうかを確認するには、次のステップを実行します。

  1. レジストリ エディター (regedit.exe) を開き、次の場所に移動します。 HKEY_CURRENT_USER\Software\Microsoft\Command Processor\ HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Command Processor\
  2. いずれかの場所に Autorun 値があるかどうかを確認します。
  3. Autorun 値がある場合は、削除します。

Windows ユーザ名に拡張 Unicode 文字が含まれている場合、AskPass レスポンスエラーが発生する可能性があります。 トラブルシューティングを行うには、新しい Windows ユーザアカウントを作成し、ファイルをそのアカウントに移行します。 詳細については、Microsoft ドキュメントの「Windows のユーザー アカウントを作成する」を参照してください。

参考資料