{"meta":{"title":"GitHub Copilot CLI 認証のトラブルシューティング","intro":"Copilot CLIにサインインするときの認証エラーを診断します。","product":"GitHub Copilot","breadcrumbs":[{"href":"/ja/copilot","title":"GitHub Copilot"},{"href":"/ja/copilot/how-tos","title":"方法"},{"href":"/ja/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/ja/copilot/how-tos/copilot-cli/set-up-copilot-cli","title":"Copilot CLIをセットアップする"},{"href":"/ja/copilot/how-tos/copilot-cli/set-up-copilot-cli/troubleshoot-copilot-cli-auth","title":"Copilot CLI 認証のトラブルシューティング"}],"documentType":"article"},"body":"# GitHub Copilot CLI 認証のトラブルシューティング\n\nCopilot CLIにサインインするときの認証エラーを診断します。\n\n## 認証エラー\n\n認証エラーが発生した場合は、次の表を使用して原因と解決策を特定します。\n\n| 問題点 | 原因 | 修正 | 詳細情報 |\n| ---------------------------------------------------- | -------------------------------- | ------------------------------- | ---- |\n| 認証情報が見つかりません | 資格情報が格納されていない | | |\n| `copilot login` を実行します。 | | | |\n| [認証情報が見つかりません](#no-authentication-information-found) | | | |\n| 401 権限がありません | トークンの取り消しまたはアクセス許可の不十分 | アクセス許可を持つトークンを生成する | |\n| [トークンの期限切れまたは取り消し](#token-expired-or-revoked) | | | |\n| Token (classic) 拒否 | | | |\n| Token (classic) (`ghp_`) | 細かい粒度を使用する personal access token | | |\n| \\[ | | | |\n| Token (classic) 拒否]\\(#token-classic-rejected) | | | |\n| 403 禁止またはポリシーが拒否されました | | | |\n| Copilot ライセンスまたはエンタープライズ/組織ポリシー | サブスクリプションと組織の設定を確認する | | |\n| [Access拒否](#access-denied) | | | |\n| キーチェーンは使用できません | システム キーチェーンがありません | | |\n| `libsecret`をインストールするか、プレーンテキストを受け入れる | | | |\n| [キーチェーンアクセスの失敗](#keychain-access-failure) | | | |\n| アカウントが間違っている | 複数のアカウントまたは環境変数の上書き | 環境変数を確認し、`/user switch` を使用します。 | |\n| [アカウントが間違っている](#wrong-account) | | | |\n\n## 認証情報が見つかりません\n\nCopilot CLI には、次のエラーが表示されます。\n\n\n\n```text\nError: No authentication information found\nCopilot can be authenticated with GitHub using an OAuth Token or a Fine-Grained Personal Access Token\n```\n\n\n\n### 原因\n\nチェックされた場所には資格情報が存在しません。\n\n### 修正\n\n認証が見つからない場所を見つけて、accessを復元するには、次の手順に従います。\n\n#### 認証の状態を確認する\n\n```bash copy\ngh auth status\n```\n\nログインしていないことを示すメッセージが表示された場合は、 `gh auth login` でログインするか、 `copilot login`で OAuth フローを使用します。\n\n#### 認証環境変数が設定されているかどうかを確認する\n\n環境変数を使用している場合は、 `COPILOT_GITHUB_TOKEN`、 `GH_TOKEN`、または `GITHUB_TOKEN` 環境変数が設定されているかどうかを確認します。\n\n```bash copy\necho $COPILOT_GITHUB_TOKEN\n```\n\nコマンドが何も出力しない場合、変数は設定されません。 変数を有効なトークンに設定します。 トークンを生成するには、[GitHub Copilot CLI の認証](/ja/copilot/how-tos/copilot-cli/set-up-copilot-cli/authenticate-copilot-cli#authenticating-with-environment-variables) を参照してください。\n\n```bash copy\n export $COPILOT_GITHUB_TOKEN=PERSONAL_ACCESS_TOKEN\n```\n\n#### macOS キーチェーン\n\n```bash copy\nsecurity find-generic-password -s copilot-cli\n```\n\n項目が見つからない場合は、 `/login` で再度認証するか、 `copilot login` して作成します。\n項目が見つかったが認証に失敗した場合は、保存された資格情報を削除し、 `/login` または `copilot login`で再び認証します。\n\n```bash copy\n security delete-generic-password -s copilot-cli\n```\n\n## トークンの期限切れまたは取り消し\n\nCopilot CLI には、次のエラーが表示されます。\n\n\n\n```text\nError: Authentication failed\n\nYour GitHub token may be invalid, expired, or lacking the required permissions.\n\nTo resolve this, try the following:\n • Start 'copilot' and run the '${LOGIN_COMMAND}' command to re-authenticate\n • If using a Fine-Grained PAT, ensure it has the 'Copilot Requests' permission enabled\n • If using COPILOT_GITHUB_TOKEN, GH_TOKEN or GITHUB_TOKEN environment variable, verify the token is valid and not expired\n • Run 'gh auth status' to check your current authentication status\n```\n\n\n\n### 原因\n\nトークンが取り消されたか、有効期限が切れているか、必要なアクセス許可なしで作成されました。\n\n### 修正\n\nGitHubに対するトークンの状態とアクセス許可を確認します。 トークンは、fine-grained personal access token (組織ではない) が所有し、\\*\\*\\*\\* を持つCopilotである必要があります。 必要に応じて、必要なアクセス許可を持つ新しいトークンを生成します。\n\n## Token (classic) 拒否\n\n`ghp_`で始まるトークンは暗黙的に無視され、CLI はトークンが設定されていないかのように動作します。\n\n### 原因\n\nクラシック personal access tokens は、 Copilot CLIではサポートされていません。\n\n### 修正\n\nきめ細かい personal access token を必要なスコープで生成します。\n\n## Access拒否\n\nCopilot CLI には、次のいずれかのエラーが表示されます。\n\n```text\nError: Access denied by policy settings\n\nYour Copilot CLI policy setting may be preventing access. This can happen when:\n • Your organization has restricted Copilot access\n • Your Copilot subscription does not include this feature\n • Required policies have not been enabled by your administrator\n\nTo resolve this, visit your Copilot settings: \n```\n\n### 原因\n\n組織ポリシーが GitHub Copilot CLIをブロックしているか、ユーザー アカウントに GitHub Copilot ライセンスがありません。\n\n### 修正\n\n* アカウントにアクティブな GitHub Copilot ライセンスがあることを確認します。\n* 組織の管理者に、組織ポリシーで GitHub Copilot CLI を有効にするよう依頼します。\n\n## キーチェーンアクセス失敗\n\nログイン中に、CLI によってシステム キーチェーンが使用できないことを確認するメッセージが表示され、資格情報をプレーンテキストで格納するかどうかを確認するメッセージが表示されます。\n\n```text\nSystem keychain unavailable. Store token in plaintext config file? (y/N)\n```\n\n### 原因\n\nシステム キーチェーンにアクセスできません。 これは、 `libsecret`、ヘッドレス サーバー、またはアクセス許可の問題があるシステムがない Linux システムで発生する可能性があります。\n\n### 修正\n\nオペレーティング システムの手順に従って、安全に資格情報の保存を復元します。\n\n#### macOS または Windows\n\nmacOS では、キーチェーン Access アプリが使用可能であることを確認し、ログイン キーチェーンのロックを解除できます。\nWindowsで、Credential Manager が使用可能であることを確認し、Windows Vault にアクセスできます。\nシステム資格情報マネージャーにアクセスできない場合は、プロンプトが表示された場合はプレーンテキストストレージを使用するか、環境変数トークンを用いて認証し、`/login` または `copilot login` を再度実行してください。\n\n#### Linux\n\nLinux では、システム キーリングを使用するか、プレーンテキストで資格情報を格納します。\n\n1. `secret-tool`がインストールされているかどうかを確認します。\n\n ```bash copy\n command -v secret-tool\n ```\n\n2. `secret-tool`が見つからない場合、または検索コマンドが結果を返さない場合は、`libsecret`とその依存関係をインストールします。 たとえば、Debian と Ubuntu では、次のコマンドを使用できます。\n\n ```bash copy\n sudo apt install libsecret-1-0 gnome-keyring seahorse\n ```\n\n3. `secret-tool`がインストールされたら、キーリングで保存された資格情報を検索します。\n\n ```bash copy\n secret-tool search copilot-cli\n ```\n\n コマンドから 1 つ以上の結果が返された場合、資格情報はキーリングに存在します。 ターミナルで`copilot login`を実行するか、`/login`内でCopilot CLIをもう一度実行してください。\n\n## アカウントが間違っている\n\n間違ったユーザーが認証されているか、トークンが間違った組織に属しています。\n\n### 原因\n\n複数のアカウントが格納されているか、環境変数が格納されているトークンをオーバーライドしています。\n\n### 修正\n\nアカウントを切り替えるには、CLI プロンプトで `/user switch` を使用するか、 `/logout` でサインアウトし、正しいアカウントで `/login` を実行します。"}