{"meta":{"title":"GitHub Copilotのファイアウォールのカスタマイズまたは無効化","intro":"Copilot cloud agentおよびCopilot code reviewがアクセスできるドメインと URL を制御する方法について説明します。","product":"GitHub Copilot","breadcrumbs":[{"href":"/ja/copilot","title":"GitHub Copilot"},{"href":"/ja/copilot/how-tos","title":"方法"},{"href":"/ja/copilot/how-tos/copilot-on-github","title":"Copilot で GitHub"},{"href":"/ja/copilot/how-tos/copilot-on-github/customize-copilot","title":"Copilot のカスタマイズ"},{"href":"/ja/copilot/how-tos/copilot-on-github/customize-copilot/customize-the-firewall","title":"ファイアウォールをカスタマイズする"}],"documentType":"article"},"body":"# GitHub Copilotのファイアウォールのカスタマイズまたは無効化\n\nCopilot cloud agentおよびCopilot code reviewがアクセスできるドメインと URL を制御する方法について説明します。\n\n> \\[!NOTE]\n> ファイアウォールの構成は、 Copilot cloud agent と Copilot code reviewの両方をカバーする \\[インターネット アクセス] 設定タブから管理されます。 アクションの変数として保存された以前の構成は、そのページに保持されます。\n\n## Overview\n\n既定では、 Copilotのインターネットへのアクセスはファイアウォールによって制限されます。\n\n> \\[!NOTE]\n> Copilot code review また、以下で説明する \\[インターネット アクセス] タブの独自のセクションで、組織レベルとリポジトリ レベルの両方でファイアウォール構成をサポートしています。 これにより、Copilot code reviewとは別にCopilot cloud agentのファイアウォール規則を構成できます。 「[GitHub Copilot を使ったコードレビュー](/ja/copilot/how-tos/use-copilot-agents/request-a-code-review/use-code-review#customizing-copilot-code-reviews-environment)」を参照してください。\n\nインターネット アクセスの制限は、データ流出リスクの管理に役立ちます。\nCopilotや悪意のある命令による予期しない動作により、コードやその他の機密情報がリモートの場所に漏えいする可能性があります。\n\nファイアウォールは常に、CopilotがGitHubとの対話に用いる多数のホストへのアクセスを許可します。 エージェントが依存関係をダウンロードできるように、推奨される許可リストも既定で有効になります。\n\nCopilotファイアウォールによってブロックされている要求を行おうとすると、pull request 本文 (新しいプル要求の場合) またはコメント (既存のプル要求の場合) に警告が追加されます。 警告には、ブロックされたアドレスと要求を行おうとしたコマンドが表示されます。\n\n\n\n## Limitations\n\nエージェント ファイアウォールには、セキュリティのカバレッジに影響する重要な制限があります。\n\n* **エージェントによって開始されたプロセスにのみ適用される**: ファイアウォールは、エージェントが Bash ツール経由で開始したプロセスにのみ適用されます。 構成された Copilot セットアップ手順で開始されたモデル コンテキスト プロトコル (MCP) サーバーまたはプロセスには適用されません。\n* **GitHub Actions アプライアンス内でのみ適用されます**。ファイアウォールは、GitHub Actions アプライアンス環境内でのみ動作します。 この環境外で実行されているプロセスには適用されません。\n* **Bypass potential**: 高度な攻撃によってファイアウォールがバイパスされ、許可されていないネットワークアクセスやデータ流出の可能性があります。\n\nこれらの制限は、ファイアウォールが一般的なシナリオに対する保護を提供することを意味しますが、包括的なセキュリティ ソリューションと見なすべきではありません。\n\n## 推奨されるファイアウォール許可リストについて\n\n既定で有効になっている推奨される許可リストでは、次のアクセスが可能です。\n\n* 一般的なオペレーティング システムのパッケージ リポジトリ (Debian、Ubuntu、Red Hat など)。\n* 一般的なコンテナー レジストリ (Docker Hub、Azure Container Registry、AWS Elastic Container Registry など)。\n* 一般的なプログラミング言語 (C#、Dart、Go、Haskell、Java、JavaScript、Perl、PHP、Python、Ruby、Rust、Swift) で使われるパッケージ レジストリ。\n* 一般的な証明機関 (SSL 証明書の検証を許可するため)。\n* Playwright MCP サーバー用の Web ブラウザーのダウンロードに使われるホスト。\n\n推奨される許可リストに含まれるホストの完全な一覧については、 [Copilot 許可リスト リファレンス](/ja/copilot/reference/copilot-allowlist-reference#copilot-cloud-agent-recommended-allowlist) を参照してください。\n\n## 組織レベルでのファイアウォールの構成\n\n組織の所有者は、 Copilot cloud agent と Copilot code reviewの両方について、組織レベルですべてのファイアウォール設定を構成できます。 ファイアウォール設定にアクセスするには:\n\n1. GitHub の右上隅にあるプロフィール画像をクリックしてから、**\\[ Your organizations]** をクリックします。\n2. 組織をクリックして選択します。\n3. Organization 名の下で、**\\[ Settings]** をクリックします。 \\[設定] タブが表示されない場合は、 **\\[]** ドロップダウン メニューを選び、 **\\[設定]** をクリックします。\n\n ![組織のプロファイルのタブのスクリーンショット。 \\[設定\\] タブが濃いオレンジ色の枠線で囲まれています。](/assets/images/help/discussions/org-settings-global-nav-update.png)\n サイドバーの \\[コード、計画、自動化] で、\\[ **Copilot**] をクリックし、\\[ **インターネット アクセス**] をクリックします。\n\n\\[インターネット アクセス] ページには、 Copilot cloud agent と Copilot code reviewのセクションが個別に用意されているため、それぞれについて個別に次の設定を構成できます。\n\n### ファイアウォールの有効化または無効化\n\n> \\[!WARNING]\n> ファイアウォールを無効にすると、 Copilot が任意のホストに接続でき、コードやその他の機密情報が流出するリスクが高まります。\n\n1. \\[インターネット アクセス] で、\\[ファイアウォールの **有効化** ] 設定を **\\[有効]**、\\[ **無効]**、または **\\[リポジトリが決定できるようにする** ] (既定値) に設定します。\n\n### 推奨される許可リストの有効化または無効化\n\n1. \\[インターネット アクセス] で、\\[ **推奨される許可リスト** ] 設定を **\\[有効]**、\\[ **無効]**、または \\[ **リポジトリが決定できるようにする** ] (既定値) に設定します。\n\n### リポジトリがカスタム許可リストルールを追加できるかどうかを制御する\n\nデフォルトでは、リポジトリ管理者はファイアウォール許可リストに独自のエントリを追加できます。 組織の所有者は、これを無効にして、リポジトリがカスタム規則を追加できないようにすることができます。\n\n1. \\[インターネット アクセス] で、\\[リポジトリの **カスタム規則を許可する** ] 設定を **\\[有効** ] (既定) または **\\[無効]** に設定します。\n\n### 組織のカスタム許可リストの管理\n\n組織のカスタム許可リストに追加された項目は、組織内のすべてのリポジトリに適用されます。 これらの項目は、リポジトリ レベルでは削除できません。 組織レベルの規則とリポジトリ レベルの規則が組み合わされています。\n\n1. \\[インターネット アクセス] で、\\[ **組織のカスタム許可リスト**] をクリックします。\n2. 許可リストに含めるアドレスを追加します。 以下を含めることができます。\n\n * **ドメイン** (たとえば、`packages.contoso.corp`)。 指定したドメインと任意のサブドメインに許可するトラフィック。\n\n**Example**: `packages.contoso.corp` では、トラフィックは `packages.contoso.corp` と `prod.packages.contoso.corp` に許可されますが、`artifacts.contoso.corp`は許可されません。\n\n* **URLs** (例: `https://packages.contoso.corp/project-1/`)。 トラフィックは指定されたスキーム (`https`) とホスト (`packages.contoso.corp`) にのみ許可され、指定されたパスと子孫パスに制限されます。\n\n**Example**: `https://packages.contoso.corp/project-1/` では、`https://packages.contoso.corp/project-1/` と `https://packages.contoso.corp/project-1/tags/latest` へのトラフィックは許可されますが、`https://packages.contoso.corp/project-2`、`ftp://packages.contoso.corp`、または `https://artifacts.contoso.corp` は許可されません。\n\n1. **\\[ルールの追加]** をクリックします。\n2. リストを検証後、**\\[Save changes]** をクリックします。\n\n## リポジトリ レベルでのファイアウォールの構成\n\nリポジトリ管理者は、ファイアウォールの有効化または無効化、推奨される許可リストの有効化または無効化、カスタム許可リストの管理など、リポジトリ レベルでファイアウォール設定を構成できます。 組織レベルの構成によっては、これらの設定の一部がロックされている場合があります。 リポジトリの設定ページには、 Copilot cloud agent と Copilot code reviewのセクションも個別に用意されているため、これらの設定は個別に構成できます。\n\nファイアウォール設定にアクセスするには:\n\n1. GitHub で、リポジトリのメイン ページに移動します。\n2. リポジトリ名の下にある ** \\[Settings]** をクリックします。 \\[設定] タブが表示されない場合は、 **\\[]** ドロップダウン メニューを選び、 **\\[設定]** をクリックします。\n\n ![タブを示すリポジトリ ヘッダーのスクリーンショット。 \\[設定\\] タブが濃いオレンジ色の枠線で強調表示されています。](/assets/images/help/repository/repo-actions-settings.png)\n3. サイドバーの \\[Code, planning, and automation]\\(コード、計画、自動化) の下で、 \\[ **Copilot** ]、\\[ **インターネット アクセス**] の順にクリックします。\n\n### ファイアウォールの有効化または無効化\n\n> \\[!NOTE]\n> この設定は、組織レベルの **\\[ファイアウォールの有効化]** 設定が \\[リポジトリで決定できるようにする] に設定されている場合にのみ **、リポジトリ** レベルで変更できます。 組織レベルの設定が **有効** または **無効**の場合、個々のリポジトリに対してこの設定を変更することはできません。\n\n1. \\[ **ファイアウォールを有効にする]** 設定のオンとオフを切り替えます。\n\n### 推奨される許可リストの有効化または無効化\n\n> \\[!NOTE]\n> この設定は、組織レベルの **\\[推奨される許可リスト** ] 設定が \\[リポジトリで決定できるようにする] に設定されている場合にのみ **、リポジトリ** レベルで変更できます。 組織レベルの設定が **有効** または **無効**の場合、個々のリポジトリに対してこの設定を変更することはできません。\n\n1. 推奨される **許可リスト** の設定をオンまたはオフに切り替えます。\n\n### カスタム許可リストの管理\n\n> \\[!NOTE]\n> カスタム許可リスト ルールは、組織レベルの \\[Allow repository custom rules]\\(リポジトリの許可) カスタム ルール設定が **\\[有効]** に設定されている場合にのみ **、リポジトリ** レベルで追加できます。 詳細については、 [リポジトリーがカスタム許可リスト規則を追加できるかどうかを制御するを参照](#controlling-whether-repositories-can-add-custom-allowlist-rules)してください。\n\n1. \\[ **カスタム許可リスト**] をクリックします。\n2. 許可リストに含めるアドレスを追加します。 以下を含めることができます。\n\n * **ドメイン** (たとえば、`packages.contoso.corp`)。 指定したドメインと任意のサブドメインに許可するトラフィック。\n\n**Example**: `packages.contoso.corp` では、トラフィックは `packages.contoso.corp` と `prod.packages.contoso.corp` に許可されますが、`artifacts.contoso.corp`は許可されません。\n\n* **URLs** (例: `https://packages.contoso.corp/project-1/`)。 トラフィックは指定されたスキーム (`https`) とホスト (`packages.contoso.corp`) にのみ許可され、指定されたパスと子孫パスに制限されます。\n\n**Example**: `https://packages.contoso.corp/project-1/` では、`https://packages.contoso.corp/project-1/` と `https://packages.contoso.corp/project-1/tags/latest` へのトラフィックは許可されますが、`https://packages.contoso.corp/project-2`、`ftp://packages.contoso.corp`、または `https://artifacts.contoso.corp` は許可されません。\n\n1. **\\[ルールの追加]** をクリックします。\n2. リストを検証後、**\\[Save changes]** をクリックします。\n\n## 詳細については、次を参照してください。\n\n* [変数に情報を格納する](/ja/actions/how-tos/write-workflows/choose-what-workflows-do/use-variables#creating-configuration-variables-for-a-repository)\n* [開発環境を構成する](/ja/copilot/how-tos/copilot-on-github/customize-copilot/customize-cloud-agent/customize-the-agent-environment)"}