1
0
mirror of synced 2025-12-23 11:54:18 -05:00
Files
docs/content/apps/maintaining-github-apps/managing-allowed-ip-addresses-for-a-github-app.md
2025-07-01 19:32:09 +00:00

3.4 KiB

title, intro, versions, topics, shortTitle, redirect_from
title intro versions topics shortTitle redirect_from
Managing allowed IP addresses for a GitHub App You can add an IP allow list to your {% data variables.product.prodname_github_app %} registration to prevent your app from being blocked by an enterprise or organization's own allow list.
fpt ghec
* *
GitHub Apps
Manage allowed IP addresses
/developers/apps/building-github-apps/managing-allowed-ip-addresses-for-a-github-app

About IP address allow lists for {% data variables.product.prodname_github_apps %}

Enterprise and organization owners can restrict access to assets by configuring an IP address allow list. This list specifies the IP addresses that actors can use to access their resources. For more information, see AUTOTITLE.

When an organization or enterprise has an allow list, third-party applications that connect via a {% data variables.product.prodname_github_app %} will be denied access unless either of the following condition sets are true:

  • The creator of the {% data variables.product.prodname_github_app %} has configured an allow list for the application that specifies the IP addresses at which their application runs. See below for details of how to do this, and
  • The organization or enterprise owner has chosen to permit the addresses in the {% data variables.product.prodname_github_app %}'s allow list to be added to their own allow list. For more information, see [Managing allowed IP addresses for your organization](/{% ifversion fpt %}enterprise-cloud@latest/{% endif %}organizations/keeping-your-organization-secure/managing-allowed-ip-addresses-for-your-organization#allowing-access-by-github-apps){% ifversion fpt %} in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}.{% endif %}

or

  • The organization or enterprise owner has added an IP allow list entry for the IP addresses from which the application runs. See [Adding an allowed IP address](/{% ifversion fpt %}enterprise-cloud@latest/{% endif %}organizations/keeping-your-organization-secure/managing-security-settings-for-your-organization/managing-allowed-ip-addresses-for-your-organization#adding-an-allowed-ip-address){% ifversion fpt %} in the {% data variables.product.prodname_ghe_cloud %} documentation.{% else %}.{% endif %}

{% data reusables.apps.ip-allow-list-only-apps %}

Adding an IP address allow list to a {% data variables.product.prodname_github_app %} registration

{% data reusables.identity-and-permissions.ipv6-allow-lists %} {% data reusables.identity-and-permissions.ip-address-add-or-remove-caching %}

{% data reusables.apps.settings-step %} {% data reusables.apps.enterprise-apps-steps %} {% data reusables.user-settings.modify_github_app %} {% data reusables.identity-and-permissions.ip-allow-lists-add-ip %} {% data reusables.identity-and-permissions.ip-allow-lists-add-description %} The description is for your reference and is not used in the allow list of organizations where the {% data variables.product.prodname_github_app %} is installed. Instead, organization allow lists will include "Managed by the NAME {% data variables.product.prodname_github_app %}" as the description. {% data reusables.identity-and-permissions.ip-allow-lists-add-entry %}