Managing allowed IP addresses for your organization

About allowed IP addresses

You can restrict access to private organization assets by configuring an allow list for specific IP addresses. たとえば、自分のオフィスのネットワークのIPアドレスからのアクセスのみを許可できます。 IP アドレスの許可リストは、許可リストにない IP アドレスからの Web、API、Git を介したアクセスをブロックします。

CIDR表記を使って、単一のIPアドレスもしくはアドレスの範囲に対してアクセスを承認できます。 詳細については、ウィキペディアの CIDR 表記に関するページを参照してください。

IP許可リストを強制するには、まずIPアドレスをリストに追加し、それからIP許可リストを有効化しなければなりません。 リストが完成したら、特定の IP アドレスがリスト内のいずれかの有効なエントリによって許可されるかどうかを確認できます。

IP 許可リストを有効にするには、現在の IP アドレスまたは一致する範囲を追加する必要があります。

If you set up an allow list you can also choose to automatically add to your allow list any IP addresses configured for GitHub Apps that you install in your organization. The creator of a GitHub App can configure an allow list for their application, specifying the IP addresses at which the application runs. By inheriting their allow list into yours, you avoid connection requests from the application being refused. For more information, see "Allowing access by GitHub Apps."

You can also configure allowed IP addresses at the enterprise account level, and the entries in the enterprise account's allow list are inherited by all the organizations owned by the enterprise. 組織の所有者は、組織の許可リストにエントリを追加できますが、エンタープライズ アカウントの許可リストから継承されたエントリを管理することはできません。また、エンタープライズの所有者は、組織の許可リストに追加されたエントリを管理できません。 For more information, see "Enforcing policies for security settings in your enterprise."

Adding an allowed IP address

それぞれに IP アドレスまたはアドレス範囲を含むエントリを追加することで、IP 許可リストを作成できます。 エントリの追加が完了したら、特定の IP アドレスがリスト内のいずれかの有効なエントリによって許可されるかどうかを確認できます。

Enterprise 内の Organization が所有する プライベート アセットへのアクセスがリストによって制限される前に、許可 IP アドレスも有効にする必要があります。

1. GitHub.com の右上隅にあるプロファイル写真をクリックし、 [自分の Organization] をクリックします。

2. 組織の隣の [設定] をクリックします。

3. In the "Security" section of the sidebar, click Authentication security.

4. "IP allow list（IP許可リスト）"セクションの下部で、IPアドレスもしくはCIDR表記でアドレスの範囲を入力してください。

5. あるいは、許可された IP アドレスもしくはIPアドレスの範囲の説明を入力してください。

6. [Add] (追加) をクリックします。

7. 必要に応じて、特定の IP アドレスがリスト内のいずれかの有効なエントリによって許可されるかどうかを確認できます。 詳しくは、「IP アドレスが許可されているかどうかを確認する」を参照してください。

Enabling allowed IP addresses

IP 許可リストを作成すると、許可 IP アドレスを有効にすることができます。 許可 IP アドレスを有効にすると、IP 許可リスト内のいずれかの有効なエントリが、GitHub によってすぐに適用されます。

IP 許可リストを有効にする前に、特定の IP アドレスからの接続が、許可リストによって許可されるかどうかを確認できます。 詳しくは、「IP アドレスが許可されているかどうかを確認する」を参照してください。

1. GitHub.com の右上隅にあるプロファイル写真をクリックし、 [自分の Organization] をクリックします。

2. 組織の隣の [設定] をクリックします。

3. In the "Security" section of the sidebar, click Authentication security.

4. Under "IP allow list", select Enable IP allow list.

5. Click Save.

Allowing access by GitHub Apps

If you're using an allow list, you can also choose to automatically add to your allow list any IP addresses configured for GitHub Apps that you install in your organization.

許可リストの設定で [Enable IP allow list configuration for installed GitHub Apps] (インストールされた GitHub Apps の IP 許可リストの設定を有効化する) を選択した場合、インストールされた GitHub Apps からの IP アドレスが許可リストに追加されます。 これは、許可リストがその時点で有効化されているかどうかに関係なく行われます。 GitHub Appをインストールして、その後にそのアプリケーションの作者が許可リスト中のアドレスを変更した場合、あなたの許可リストにはそれらの変更が自動的に反映されます。

GitHub Appsから自動的に追加されたIPアドレスは、descriptionフィールドを見れば判別できます。 それらのIPアドレスの説明は"Managed by the NAME GitHub App"となっています。 手動で追加されたアドレスとは異なり、GitHub Appsから自動で追加されたIPアドレスは編集、削除、無効化できません。

For more information about how to create an allow list for a GitHub App you have created, see "Managing allowed IP addresses for a GitHub App."

1. GitHub.com の右上隅にあるプロファイル写真をクリックし、 [自分の Organization] をクリックします。

2. 組織の隣の [設定] をクリックします。

3. In the "Security" section of the sidebar, click Authentication security.

4. Under "IP allow list", select Enable IP allow list configuration for installed GitHub Apps.

5. Click Save.

Editing an allowed IP address

IP 許可リストのエントリを編集できます。 有効なエントリを編集すると、変更がすぐに適用されます。

エントリの編集が終了した後で、リストを有効にしたら、許可リストが特定の IP アドレスからの接続を許可するかどうかを確認できます。

1. GitHub.com の右上隅にあるプロファイル写真をクリックし、 [自分の Organization] をクリックします。

2. 組織の隣の [設定] をクリックします。

3. In the "Security" section of the sidebar, click Authentication security.

4. [IP allow list](IP 許可リスト) の下で、編集したいエントリの右で [Edit] (編集) をクリックしてください。

5. IPアドレスもしくはアドレスの範囲をCIDR表記で入力してください。

6. 許可された IP アドレスもしくはIPアドレスの範囲の説明を入力してください。

7. Click Update.

8. 必要に応じて、特定の IP アドレスがリスト内のいずれかの有効なエントリによって許可されるかどうかを確認できます。 詳しくは、「IP アドレスが許可されているかどうかを確認する」を参照してください。

Checking if an IP address is permitted

許可リストが現時点で有効になっていなくても、特定の IP アドレスがリスト内のいずれかの有効なエントリによって許可されるかどうかを確認できます。

1. GitHub.com の右上隅にあるプロファイル写真をクリックし、 [自分の Organization] をクリックします。

2. 組織の隣の [設定] をクリックします。

3. In the "Security" section of the sidebar, click Authentication security.

4. [IP アドレスの確認] で、IP アドレスを入力します。

Deleting an allowed IP address

1. GitHub.com の右上隅にあるプロファイル写真をクリックし、 [自分の Organization] をクリックします。

2. 組織の隣の [設定] をクリックします。

3. In the "Security" section of the sidebar, click Authentication security.

4. [IP allow list](IP 許可リスト) の下の編集したいエントリの右で、 [Delete] (削除) をクリックしてください。

5. 恒久的にエントリを削除するには、 [Yes, delete this IP allow list entry] (はい、この IP 許可リストを削除してください) をクリックしてください。

Using GitHub Actions with an IP allow list

セルフホスト型の またはより大きなホスト型のランナーが GitHub と通信できるようにするには、該当するランナーの IP アドレスまたは IP アドレス範囲を Enterprise 用に構成した IP 許可リストに追加します。