GitHub Desktop での GitHub への認証

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

Platform navigation

この記事の内容

認証について

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

認証する前には、GitHub でアカウントを既に持っている必要があります。詳細については、「GitHub でのアカウントの作成」を参照してください。Enterprise Managed Users を使う organization に属していて、アカウントをお持ちでない場合、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 Desktop で認証エラーが発生した場合は、エラーメッセージを使用してトラブルシューティングを行うことができます。

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

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

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

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

  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 に追加する」をご覧ください。

参考資料