GitHub Desktop での GitHub への認証

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

Platform navigation

この記事の内容

認証について

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

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

GitHub アカウントへの認証を行う

  1. メニュー バーで [GitHub Desktop] を選んでから、[Settings] をクリックします。

    Mac のメニュー バーのスクリーンショット。 開かれた [GitHub Desktop] ドロップダウン メニューで、カーソルが [Settings] をポイントしており、それが青色で強調されています。

  2. [Settings] ウィンドウの [Accounts] ペインで、適切な [Sign Into] ボタンをクリックします。 GitHub Enterprise Server または データ所在地付き GitHub Enterprise Cloud にサインインするには、[Sign Into GitHub Enterprise] を使います。

    [Settings] ウィンドウの [Accounts] ペインのスクリーンショット。 [Sign Into GitHub.com] と [Sign Into GitHub Enterprise] というラベルの付いた青いボタンが示されています。

  3. GitHub Enterprise のアカウントにサインインする場合は、[Sign in] モーダル ウィンドウで、GitHub にアクセスする URL を入力し、[Continue] をクリックします。

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

  5. GitHub を認証するには、ブラウザーで資格情報を入力し、[Sign in] をクリックします。

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

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

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

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

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

GitHub アカウントへの認証を行う

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

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

  2. [Options] ウィンドウの [Accounts] ペインで、適切な [Sign Into] ボタンをクリックします。 GitHub Enterprise Server または データ所在地付き GitHub Enterprise Cloud にサインインするには、[Sign Into GitHub Enterprise] を使います。

    [オプション] ウィンドウの [アカウント] ペインのスクリーンショット。 [Sign Into GitHub.com] と [Sign Into GitHub Enterprise] というラベルの付いた青いボタンが示されています。

  3. GitHub Enterprise のアカウントにサインインする場合は、[Sign in] モーダル ウィンドウで、GitHub にアクセスする URL を入力し、[Continue] をクリックします。

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

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

  5. GitHub を認証するには、ブラウザーで資格情報を入力し、[Sign in] をクリックします。

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

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

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

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

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

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

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

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

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

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

    Mac の [GitHub Desktop] メニュー バーのスクリーンショット。 展開された [Help] ドロップダウン メニューの [Show Logs in Finder] が青色で強調表示されています。

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

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

    Windows の [GitHub Desktop] メニュー バーのスクリーンショット。 展開された [Help] ドロップダウン メニューで、[Show Logs in Explorer] がオレンジ色で強調されています。

  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 のユーザー アカウントを作成する」を参照してください。

参考資料